$k. Date

new Date(valueopt, monthopt, dayopt)

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

Parameters:
NameTypeAttributesDescription
value<optional>

Date or year

month<optional>

Month number

day<optional>

Day number

Represents a date

Methods

(static) parse(string, languageopt)

Parse the date/time string. Both ISO 8601 and localized strings are supported.

Parameters:
NameTypeAttributesDescription
stringstring

The string representation

languagestring<optional>

Either an ISO 639-1 or ISO 639-2B language code (e.g. "en" or "eng"), or a locale name without encoding (e.g. "en_US"). Locale names and language codes are not interchangeable, e.g. the values for "de" and "de_DE" are separated. If not defined, the locale/language of the process will be used. Ignored if the attribute is not translated.

Throws:
Returns:

The parsed date/time

equals(value) → {boolean}

Returns true if the values are equal

Parameters:
NameTypeDescription
value

Another attribute value

Returns:
Type: 
boolean

getDayNumber() → {number}

Returns the number of the day, e.g. 18 for 2011-03-18

Returns:
Type: 
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: 
number

getYear() → {number}

Returns the full year

Returns:
Type: 
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: 
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: 
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: 
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: 
Date

setDayNumber(day)

Sets the number of the day, e.g. 23 for 2012-05-23

Parameters:
NameTypeDescription
daynumber

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.

Parameters:
NameTypeDescription
monthnumber

setYear(year)

Sets the full year. The year is not modified, so setYear(99) sets the year 99, not 1999.

Parameters:
NameTypeDescription
yearnumber

toDate() → {Date}

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

Returns:
Type: 
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 )

toString(languageopt) → {string}

Returns the string representation. Equivalent to valueString()

Parameters:
NameTypeAttributesDescription
languagestring<optional>

Either an ISO 639-1 or ISO 639-2B language code (e.g. "en" or "eng"), or a locale name without encoding (e.g. "en_US"). Locale names and language codes are not interchangeable, e.g. the values for "de" and "de_DE" are separated. If not defined, the locale/language of the process will be used. Ignored if the attribute is not translated.

Throws:

If an invalid language was specified

Type
$k.exception.InvalidLanguage
Returns:
Type: 
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: 
number

valueString(languageopt) → {string}

Returns the string representation

Parameters:
NameTypeAttributesDescription
languagestring<optional>

Either an ISO 639-1 or ISO 639-2B language code (e.g. "en" or "eng"), or a locale name without encoding (e.g. "en_US"). Locale names and language codes are not interchangeable, e.g. the values for "de" and "de_DE" are separated. If not defined, the locale/language of the process will be used. Ignored if the attribute is not translated.

Throws:

If an invalid language was specified

Type
$k.exception.InvalidLanguage
Returns:
Type: 
string