A Temporal.Instant
is an exact point in time, with a precision innanoseconds. No time zone or calendar information is present. Therefore,Temporal.Instant
has no concept of days, months, or even hours.
A Temporal.PlainDate
represents a calendar date. "Calendar date" refers to theconcept of a date as expressed in everyday usage, independent of any timezone. For example, it could be used to represent an event on a calendarwhich happens during the whole day no matter which time zone it's happeningin.
A Temporal.PlainDateTime
represents a calendar date and wall-clock time, witha precision in nanoseconds, and without any time zone. Of the Temporalclasses carrying human-readable time information, it is the most generaland complete one. Temporal.PlainDate
, Temporal.PlainTime
, Temporal.PlainYearMonth
,and Temporal.PlainMonthDay
all carry less information and should be used whencomplete information is not required.
- add
- calendarId
- compare
- day
- dayOfWeek
- dayOfYear
- daysInMonth
- daysInWeek
- daysInYear
- equals
- era
- eraYear
- from
- hour
- inLeapYear
- microsecond
- millisecond
- minute
- month
- monthCode
- monthsInYear
- nanosecond
- round
- second
- since
- subtract
- toJSON
- toLocaleString
- toPlainDate
- toPlainTime
- toString
- toZonedDateTime
- until
- valueOf
- weekOfYear
- with
- withCalendar
- withPlainTime
- year
- yearOfWeek
A Temporal.PlainMonthDay
represents a particular day on the calendar, butwithout a year. For example, it could be used to represent a yearlyrecurring event, like "Bastille Day is on the 14th of July."
A Temporal.PlainTime
represents a wall-clock time, with a precision innanoseconds, and without any time zone. "Wall-clock time" refers to theconcept of a time as expressed in everyday usage — the time that you readoff the clock on the wall. For example, it could be used to represent anevent that happens daily at a certain time, no matter what time zone.
A Temporal.PlainYearMonth
represents a particular month on the calendar. Forexample, it could be used to represent a particular instance of a monthlyrecurring event, like "the June 2019 meeting".
- add
- calendarId
- compare
- day
- dayOfWeek
- dayOfYear
- daysInMonth
- daysInWeek
- daysInYear
- epochMilliseconds
- epochNanoseconds
- equals
- era
- eraYear
- from
- getTimeZoneTransition
- hour
- hoursInDay
- inLeapYear
- microsecond
- millisecond
- minute
- month
- monthCode
- monthsInYear
- nanosecond
- offset
- offsetNanoseconds
- round
- second
- since
- startOfDay
- subtract
- timeZoneId
- toInstant
- toJSON
- toLocaleString
- toPlainDate
- toPlainDateTime
- toPlainTime
- toString
- until
- valueOf
- weekOfYear
- with
- withCalendar
- withPlainTime
- withTimeZone
- year
- yearOfWeek
Options to control the result of until()
and since()
methods inTemporal
types.
Options for assigning fields using with()
or entire objects withfrom()
.
Any of these types can be passed to Temporal methods instead of a calendar ID.
Options for assigning fields using Duration.prototype.with()
or entireobjects with Duration.from()
, and for arithmetic withDuration.prototype.add()
and Duration.prototype.subtract()
.
The round
method of the Temporal.Duration
accepts one requiredparameter. If a string is provided, the resulting Temporal.Duration
object will be rounded to that unit. If an object is provided, thesmallestUnit
and/or largestUnit
property is required, while otherproperties are optional. A string parameter is treated the same as anobject whose smallestUnit
property value is that string.
Options to control behavior of Duration.prototype.total()
When the name of a unit is provided to a Temporal API as a string, it isusually singular, e.g. 'day' or 'hour'. But plural unit names like 'days'or 'hours' are also accepted.
round
methods take one required parameter. If a string is provided, theresulting Temporal.Duration
object will be rounded to that unit. If anobject is provided, its smallestUnit
property is required while otherproperties are optional. A string is treated the same as an object whosesmallestUnit
property value is that string.
Any of these types can be passed to Temporal methods instead of a time zone ID.
Options for conversions of Temporal.PlainDateTime
to Temporal.Instant
Options for outputting precision in toString() on types with seconds
Options to control behaviour of ZonedDateTime.prototype.getTimeZoneTransition()
The Temporal.Now
object has several methods which give information aboutthe current date, time, and time zone.