DateTime

new DateTime(valueopt, monthopt, dayopt, hoursopt, minutesopt, secondsopt)

Constructs a DateTime from the argument(s), which can be a Date object, undefined, milliseconds (UTC) or component values. If undefined, the current date and time is returned

Parameters:

Name	Attributes	Description
`value`	<optional>	Date or year
`month`	<optional>	Month number
`day`	<optional>	Day number
`hours`	<optional>	Hours
`minutes`	<optional>	Minutes
`seconds`	<optional>	Seconds Represents a date and time without timezone

Methods

(static) parse(string, languageopt)

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

Parameters:

Name	Type	Attributes	Description
`string`	string		The string representation
`language`	string	<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
If value is invalid
Type
$k.exception.InvalidValue

Returns:

The parsed date/time

equals(value) → {boolean}

Returns true if the values are equal

Parameters:

Name	Type	Description
`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

getHours() → {number}

Returns the hours

Returns:

Type:: number

getMinutes() → {number}

Returns the minutes

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

getSeconds() → {number}

Returns the seconds

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:

Name	Type	Description
`day`	number

setHours(hours)

Sets the hours

Parameters:

Name	Type	Description
`hours`	number

setMinutes(minutes)

Sets the minutes.

Parameters:

Name	Type	Description
`minutes`	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.

Parameters:

Name	Type	Description
`month`	number

setSeconds(seconds)

Sets the seconds.

Parameters:

Name	Type	Description
`seconds`	number

setYear(year)

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

Parameters:

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:: 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: $k.Date#toJSON

toString(languageopt) → {string}

Returns the string representation. Equivalent to valueString()

Parameters:

Name	Type	Attributes	Description
`language`	string	<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

toUTCDate() → {Date}

Returns the date/time as a Javascript date object. Assumes that this is an UTC date/time

Returns:

Type:: Date

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:

Name	Type	Attributes	Description
`language`	string	<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