new $k.Date(value, month, day)
Constructs a Date from the argument(s), which can be a Date object, undefined, milliseconds (UTC) or component values.
If undefined, the current date is returned
Name | Type | Description |
---|---|---|
value |
optional
Date or year |
|
month |
optional
Month number |
|
day |
optional
Day number Represents a date |
Methods
static$k.Date.parse(string, language)
Parse the date/time string. Both ISO 8601 and localized strings are supported.
Name | Type | Description |
---|---|---|
string |
string |
The string representation |
language |
string |
optional
Language of the value. Either ISO 639-1 (2-letter code, e.g. "en") or ISO 639-2B (3-letter code, e.g. "eng"). If not defined, the current language will be used. |
Throws:
Type | Description |
---|---|
$k.exception.InvalidLanguage | If an invalid language was specified |
Returns:
The parsed date/timeequals() : boolean
Returns true if the values are equal
Returns:
Type | Description |
---|---|
boolean |
getDayNumber() : number
Returns the number of the day, e.g. 18 for 2011-03-18
Returns:
Type | Description |
---|---|
number |
getMonthNumber() : number
Returns the number of the month.
Unlike Date.prototype.month(), this is not the 0-based month index,
so for January getMonthNumber() returns 1, not 0
Returns:
Type | Description |
---|---|
number |
getYear() : number
Returns the full year
Returns:
Type | Description |
---|---|
number |
maxDate() : $k.Date
Returns the latest exact Javascript date that is within the range of this date/time, e.g. 2007-03-01T23:59:59.999 for the date 2007-03-01.
Assumes that this is a date/time of the local timezone
Returns:
Type | Description |
---|---|
$k.Date |
maxUTCDate() : $k.Date
Returns the latest exact Javascript date that is within the range of this date/time, e.g. 2007-03-01T23:59:59.999 for the date 2007-03-01.
Assumes that this is a date/time of the local timezone
Returns:
Type | Description |
---|---|
$k.Date |
minDate() : $k.Date
Returns the earliest exact Javascript date that is within the range of this date/time, e.g. 2007-03-01T0:00:00.0 for the date 2007-03-01.
Assumes that this is a date/time of the local timezone
Returns:
Type | Description |
---|---|
$k.Date |
minUTCDate() : $k.Date
Returns the earliest exact Javascript date that is within the range of this date/time, e.g. 2007-03-01T0:00:00.0 for the date 2007-03-01.
Assumes that this is an UTC date/time
Returns:
Type | Description |
---|---|
$k.Date |
setDayNumber(day)
Sets the number of the day, e.g. 23 for 2012-05-23
Name | Type | Description |
---|---|---|
day |
number |
setMonthNumber(month)
Set the number of the month.
Unlike Date.prototype.month(), this is not the 0-based month index,
so for January pass 1 to setMonthNumber() , not 0.
Name | Type | Description |
---|---|---|
month |
number |
setYear(year)
Sets the full year. The year is not modified, so setYear(99) sets the year 99, not 1999.
Name | Type | Description |
---|---|---|
year |
number |
toDate() : $k.Date
Returns the date/time as a Javascript date object.
Assumes that this is a date/time of the local timezone
Returns:
Type | Description |
---|---|
$k.Date |
toISOString()
Returns an ISO 8601 representation of the date/time
- Since:
- 4.1.0
toJSON()
Returns a string representing the date/time, similar to Date.prototype.toJSON ( key )
- See:
toString(language) : string
Returns the string representation. Equivalent to valueString()
Name | Type | Description |
---|---|---|
language |
string |
optional
Language of the value. Either ISO 639-1 (2-letter code, e.g. "en") or ISO 639-2B (3-letter code, e.g. "eng"). If not defined, the current language will be used. |
Throws:
Type | Description |
---|---|
$k.exception.InvalidLanguage | If an invalid language was specified |
Returns:
Type | Description |
---|---|
string |
toUTC()
Returns the date/time as a UTC date/time
Assumes that this is a local date/time
- Since:
- 4.1.0
valueOf() : number
Returns the internal millisecond value. Allows comparing date/time values, since the comparision operators call valueOf()
Returns:
Type | Description |
---|---|
number |
valueString(language) : string
Returns the string representation
Name | Type | Description |
---|---|---|
language |
string |
optional
Language of the value. Either ISO 639-1 (2-letter code, e.g. "en") or ISO 639-2B (3-letter code, e.g. "eng"). If not defined, the current language will be used. |
Throws:
Type | Description |
---|---|
$k.exception.InvalidLanguage | If an invalid language was specified |
Returns:
Type | Description |
---|---|
string |