JS Temporal Reference

Temporal objects are the core part of the

which aims to replace the old Date object.

Temporal.Duration Length of time (e.g days, hours, minutes) Temporal.Now

Temporal.Instant A fixed point in time, independent of time zone Temporal.ZonedDateTime Date and time in a specific time zone

Temporal.PlainDate()

Temporal.PlainTime() Time of day only (14:30:00) Temporal.PlainDateTime()

Temporal.PlainYearMonth()

Temporal.PlainMonthDay()

All Temporal objects are immutable, which helps prevent bugs related to accidental modification of time values. Temporal.Duration Methods

from() Returns a new duration from an object or an ISO string with() Returns a new duration with specified field(s) modified

Returns a new duration with the absolute value of this duration add() Returns a new duration with a duration added to this duration negated() Returns a new duration with this duration negated round() Returns a new duration with this duration rounded subtract() Returns a new duration with a duration subtracted from this duration

Returns a number representing the duration in a given unit toJSON() Returns an RFC 9557 format string for JSON serialization toLocaleString()

Returns an RFC 9557 format string representation valueOf() Throws a TypeError (prevents temporals from being converted to primitives) Temporal.Duration Properties

Boolean true if the duration represents a zero duration days

hours

milliseconds

minutes

months

nanoseconds

seconds

sign

Temporal.Now Methods

Returns current time as a Temporal.Instant object plainDateISO() Returns current date as a Temporal.PlainDate object plainDateTimeISO() Returns current date and time as a Temporal.PlainDateTime object plainTimeISO() Returns current time as a Temporal.PlainTime object timeZoneId Returns system's time zone as a time zone id zonedDateTimeISO() Returns current date and time as a Temporal.ZonedDateTime object

Temporal.Instant Methods

Creates a new Temporal.Instant object from() Creates a new Instant object from another instant or a string fromEpochMilliseconds() Returns a new Instant object from a number of milliseconds fromEpochNanoseconds() Returns a new Instant object from a number of nanoseconds

Returns a new Instant with a duration added round() Returns a new Instant with this instant rounded subtract() Returns a new Instant with a duration subtracted

Returns true if two instants are identical since()