new Engine(expression [, pattern])
Kairos time engine.
Parameters:
Name | Type | Argument | Description |
---|---|---|---|
expression |
String | Number | Kairos.Engine | Literal time expression, milliseconds or a Kairos.Engine instance | |
pattern |
String |
<optional> |
Overrides Kairos pattern |
Examples
new Kairos.Engine('10:30', 'hh:mm');
new Kairos.Engine(1000);
new kairos.Engine(previousInstance);
Members
-
<protected> milliseconds :Number
-
Type:
- Number
- Default Value:
-
- 0
Methods
-
addHours(hours)
-
Adds hours to the current instance.
Parameters:
Name Type Description hours
Number Hours to add Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').addHours(1);
-
addMilliseconds(milliseconds)
-
Adds milliseconds in the current instance.
Parameters:
Name Type Description milliseconds
Number Milliseconds to add Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').addMilliseconds(500);
-
addMinutes(minutes)
-
Adds minutes to the current instance.
Parameters:
Name Type Description minutes
Number Minutes to add Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').addMinutes(30);
-
addSeconds(seconds)
-
Adds seconds in the current instance.
Parameters:
Name Type Description seconds
Number Seconds to add Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').addSeconds(30);
-
compareTo(another [, pattern])
-
Compares with another instance.
Parameters:
Name Type Argument Description another
String | Number | Kairos.Engine Expression to compare with pattern
String <optional>
Overrides Kairos pattern Returns:
Smaller -1 | Equals 0 | Bigger 1- Type
- Number
Example
new Kairos.Engine('01:00').compareTo('00:30');
-
divide(divisor)
-
Divies by the given dividend.
Parameters:
Name Type Description divisor
Number Divisor value Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').divide(2);
-
getHours()
-
Gets hours fraction in the current instance.
Returns:
Hours fraction from the instance- Type
- Number
Example
new Kairos.Engine('01:00').getHours();
-
getMilliseconds()
-
Gets milliseconds fraction in the current instance.
Returns:
Milliseconds fraction from the instance- Type
- Number
Example
new Kairos.Engine('01:00').getMilliseconds();
-
getMinutes()
-
Gets minutes fraction in the current instance.
Returns:
Minutes fraction from the instance- Type
- Number
Example
new Kairos.Engine('01:00').getMinutes();
-
getSeconds()
-
Gets seconds fraction in the current instance.
Returns:
Seconds fraction from the instance- Type
- Number
Example
new Kairos.Engine('01:00').getSeconds();
-
minus(subtrahend [, pattern])
-
Subtracts the given subtrahend.
Parameters:
Name Type Argument Description subtrahend
Number | String | Kairos.Engine pattern
String <optional>
Overrides Kairos pattern Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').minus('00:30');
-
multiply(multiplicand)
-
Multiply by the given multiplicand.
Parameters:
Name Type Description multiplicand
Number Multiplicand value Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').multiply(2);
-
plus(addend [, pattern])
-
Sums the given addend.
Parameters:
Name Type Argument Description addend
Number | String | Kairos.Engine pattern
String <optional>
Overrides Kairos pattern Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').minus('00:30');
-
removeHours(hours)
-
Removes hours from the current instance.
Parameters:
Name Type Description hours
Number Hours to remove Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').removeHours(1);
-
removeMilliseconds(milliseconds)
-
Removes milliseconds from the current instance.
Parameters:
Name Type Description milliseconds
Number Milliseconds to remove Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').removeMilliseconds(50);
-
removeMinutes(minutes)
-
Removes minutes from the current instance.
Parameters:
Name Type Description minutes
Number Minutes to remove Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').removeMinutes(30);
-
removeSeconds(seconds)
-
Removes seconds from the current instance.
Parameters:
Name Type Description seconds
Number Seconds to remove Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').removeSeconds(30);
-
setHours(hours)
-
Sets hours fraction in the current instance.
Parameters:
Name Type Description hours
Number Hours to set Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('02:00').setHours(1);
-
setMilliseconds(milliseconds)
-
Sets milliseconds fraction in the current instance.
Parameters:
Name Type Description milliseconds
Number Milliseconds to set Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').setMilliseconds(200);
-
setMinutes(minutes)
-
Sets minutes fraction in the current instance.
Parameters:
Name Type Description minutes
Number Minutes to set Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').setMinutes(30);
-
setSeconds(seconds)
-
Sets seconds fraction in the current instance.
Parameters:
Name Type Description seconds
Number Seconds to set Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').setSeconds(30);
-
toAbsolute()
-
Makes the current instance's value absolute.
Returns:
Self- Type
- Kairos.Engine
Example
new Kairos.Engine('01:00').toAbsolute();
-
toHours()
-
Returns total hours within the current instance.
Returns:
Hours within the current instance- Type
- Number
Example
new Kairos.Engine('01:00').toHours();
-
toMilliseconds()
-
Returns total milliseconds within the current instance.
Returns:
Milliseconds within the current instance- Type
- Number
Example
new Kairos.Engine('01:00').toMilliseconds();
-
toMinutes()
-
Returns total minutes within the current instance.
Returns:
Minutes within the current instance- Type
- Number
Example
new Kairos.Engine('01:00').toMinutes();
-
toSeconds()
-
Returns total seconds within the current instance.
Returns:
Seconds within the current instance- Type
- Number
Example
new Kairos.Engine('01:00').toSeconds();
-
toString(pattern, allowOverflow)
-
Returns a string representation of the object.
Parameters:
Name Type Description pattern
String Pattern to format the time expression allowOverflow
Boolean If true, when hour field is bigger than the pattern definition, it will be printed anyway Returns:
String representing the instance time- Type
- String
Example
new Kairos.Engine('22:10').toString('hh:mm');