Class: Date

$k. Date

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.
Ignored if the attribute is not translated

Throws:
Type Description
$k.exception.InvalidLanguage

If an invalid language was specified

$k.exception.InvalidValue

If value is invalid

Returns:
The parsed date/time

equals() : 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() : 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
Date

maxUTCDate() : 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
Date

minDate() : 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
Date

minUTCDate() : 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
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() : Date

Returns the date/time as a Javascript date object.
Assumes that this is a date/time of the local timezone

Returns:
Type Description
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.
Ignored if the attribute is not translated

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.
Ignored if the attribute is not translated

Throws:
Type Description
$k.exception.InvalidLanguage

If an invalid language was specified

Returns:
Type Description
string