Skip to main content

Instant

class Temporal.Instant
unstable

A Temporal.Instant is an exact point in time, with a precision in nanoseconds. No time zone or calendar information is present. Therefore, Temporal.Instant has no concept of days, months, or even hours.

For convenience of interoperability, it internally uses nanoseconds since the Unix epoch (midnight UTC on January 1, 1970). However, a Temporal.Instant can be created from any of several expressions that refer to a single point in time, including an ISO 8601 string with a time zone offset such as '2020-01-23T17:04:36.491865121-08:00'.

See https://tc39.es/proposal-temporal/docs/instant.html for more details.

Constructors Jump to heading

new
Jump to headingInstant(epochNanoseconds: bigint)

Properties Jump to heading

readonly
Jump to heading[Symbol.toStringTag]: "Temporal.Instant"
Jump to headingadd(durationLike: Omit<Temporal.Duration | DurationLike,
"years"
| "months"
| "weeks"
| "days"
> | string): Temporal.Instant
Jump to headingequals(other: Temporal.Instant | string): boolean
Jump to headinground(roundTo: RoundTo<
"hour"
| "minute"
| "second"
| "millisecond"
| "microsecond"
| "nanosecond"
>): Temporal.Instant
Jump to headingsince(
other: Temporal.Instant | string,
options?: DifferenceOptions<
"hour"
| "minute"
| "second"
| "millisecond"
| "microsecond"
| "nanosecond"
>,
): Temporal.Duration
Jump to headingsubtract(durationLike: Omit<Temporal.Duration | DurationLike,
"years"
| "months"
| "weeks"
| "days"
> | string): Temporal.Instant
Jump to headingtoLocaleString(
locales?: string | string[],
): string
Jump to headinguntil(
other: Temporal.Instant | string,
options?: DifferenceOptions<
"hour"
| "minute"
| "second"
| "millisecond"
| "microsecond"
| "nanosecond"
>,
): Temporal.Duration

Static Methods Jump to heading

Back to top