Tone.Time

↳ EXTENDS Tone.TimeBase

Tone.Time is a primitive type for encoding Time values. Tone.Time can be constructed with or without the new keyword. Tone.Time can be passed into the parameter of any method which takes time as an argument.

CONSTRUCTOR

new Tone.Time (

val

, [

units

] )

val

The time value.

type: String or Number or Object

units

The units of the value.

type: String

optional

EXAMPLE

var t = Tone.Time("4n");//a quarter note

METHODS

toNotation

quantize

toSeconds

toTicks

toMidi

toBarsBeatsSixteenths

valueOf

toFrequency

toMilliseconds

toSamples

dispose

Methods

.toNotation ( )

↪ returns Notation

Convert a Time to Notation. The notation values are will be the closest representation between 1m to 128th note.

EXAMPLE

//if the Transport is at 120bpm:
Tone.Time(2).toNotation();//returns "1m"

</>

.quantize ( )

val

The subdivision to quantize to

type: Number or Time

percent

Move the time value towards the quantized value by a percentage.

type: NormalRange

default: 1

↪ returns Number

this

Quantize the time by the given subdivision. Optionally add a percentage which will move the time value towards the ideal quantized value by that percentage.

EXAMPLE

Tone.Time(21).quantize(2) //returns 22
Tone.Time(0.6).quantize("4n", 0.5) //returns 0.55

</>

.toSeconds ( )

↪ returns Seconds

Return the time in seconds.

</>

.toTicks ( )

↪ returns Ticks

Return the time in ticks.

</>

.toMidi ( )

↪ returns Midi

Return the value as a midi note.

</>