大网数据广告活动
Web 标准与前端开发

Temporal.Instant

· 52CE 我爱测

The **`Temporal.Instant`** object represents a unique point in time, with nanosecond precision. It is fundamentally represented as the number of nanoseconds since the Unix epoch (midnight at the beginning of January 1, 1970, UTC), without any time zone or calendar system.

The Temporal.Instant object represents a unique point in time, with nanosecond precision. It is fundamentally represented as the number of nanoseconds since the Unix epoch (midnight at the beginning of January 1, 1970, UTC), without any time zone or calendar system.

Description

Temporal.Instant is semantically the same as Date. They both encapsulate a single point in time, but Temporal.Instant is more precise because it stores nanoseconds rather than milliseconds. Temporal.Instant also avoids pitfalls of Date because it does not assume any calendar or time zone information—if you want to read any date or time information such as year or month, you need to convert it to a Temporal.ZonedDateTime first, using Temporal/Instant/toZonedDateTimeISO().

You can convert from Date to Temporal.Instant using the Date.prototype.toTemporalInstant() method, which should be preferred over other methods such as Temporal/Instant/fromEpochMilliseconds because the former involves less user code and may be more optimized. You can also convert from Temporal.Instant to Date using its epoch milliseconds, such as new Date(instant.epochMilliseconds).

RFC 9557 format

Instant objects can be serialized and parsed using the RFC 9557 format, an extension to the ISO 8601 / RFC 3339 format. The string has the following form (spaces are only for readability and should not be present in the actual string):

YYYY-MM-DD T HH:mm:ss.sssssssss Z/±HH:mm
  • YYYY
    • : Either a four-digit number, or a six-digit number with a + or - sign.
  • MM
    • : A two-digit number from 01 to 12.
  • DD
    • : A two-digit number from 01 to 31. The YYYY, MM, and DD components can be separated by - or nothing.
  • T
    • : The date-time separator, which can be T, t, or a space.
  • HH
    • : A two-digit number from 00 to 23.
  • mm
    • : A two-digit number from 00 to 59. Defaults to 00.
  • ss.sssssssss
    • : A two-digit number from 00 to 59. May optionally be followed by a . or , and one to nine digits. Defaults to 00. The HH, mm, and ss components can be separated by : or nothing. You can omit either just ss or both ss and mm, so the time can be one of three forms: HH, HH:mm, or HH:mm:ss.sssssssss.
  • Z/±HH:mm
    • : Either the UTC designator Z or z, or an offset from UTC in the form + or - followed by the same format as the time component. Note that subminute precision (:ss.sssssssss) may be unsupported by other systems, and is accepted but never output. If an offset is provided, the time is interpreted in the specified offset.

As an input, you may optionally include the time zone identifier and calendar, in the same format as ZonedDateTime, but they will be ignored. Other annotations in the [key=value] format are also ignored, and they must not have the critical flag.

When serializing, you can configure the fractional second digits and offset.

Constructor

  • Temporal/Instant/Instant
    • : Creates a new Temporal.Instant object by directly supplying the underlying data.

Static methods

  • Temporal/Instant/compare
    • : Returns a number (-1, 0, or 1) indicating whether the first instant comes before, is the same as, or comes after the second instant. Equivalent to comparing the Temporal/Instant/epochNanoseconds of the two instants.
  • Temporal/Instant/from
    • : Creates a new Temporal.Instant object from another Temporal.Instant object, or an RFC 9557 string.
  • Temporal/Instant/fromEpochMilliseconds
    • : Creates a new Temporal.Instant object from the number of milliseconds since the Unix epoch (midnight at the beginning of January 1, 1970, UTC).
  • Temporal/Instant/fromEpochNanoseconds
    • : Creates a new Temporal.Instant object from the number of nanoseconds since the Unix epoch (midnight at the beginning of January 1, 1970, UTC).

Instance properties

These properties are defined on Temporal.Instant.prototype and shared by all Temporal.Instant instances.

  • Object/constructor
    • : The constructor function that created the instance object. For Temporal.Instant instances, the initial value is the Temporal/Instant/Instant constructor.
  • Temporal/Instant/epochMilliseconds
    • : Returns an integer representing the number of milliseconds elapsed since the Unix epoch (midnight at the beginning of January 1, 1970, UTC) to this instant. Equivalent to dividing epochNanoseconds by 1e6 and flooring it.
  • Temporal/Instant/epochNanoseconds
    • : Returns a BigInt representing the number of nanoseconds since the Unix epoch (midnight at the beginning of January 1, 1970, UTC) to this instant.
  • Temporal.Instant.prototype[Symbol.toStringTag]
    • : The initial value of the [Symbol.toStringTag] property is the string "Temporal.Instant". This property is used in Object.prototype.toString().

Instance methods

  • Temporal/Instant/add
    • : Returns a new Temporal.Instant object representing this instant moved forward by a given duration (in a form convertible by Temporal/Duration/from).
  • Temporal/Instant/equals
    • : Returns true if this instant is equivalent in value to another instant (in a form convertible by Temporal/Instant/from), and false otherwise. They are compared by their epoch nanoseconds. Equivalent to Temporal.Instant.compare(this, other) === 0.
  • Temporal/Instant/round
    • : Returns a new Temporal.Instant object representing this instant rounded to the given unit.
  • Temporal/Instant/since
    • : Returns a new Temporal.Duration object representing the duration from another instant (in a form convertible by Temporal/Instant/from) to this instant. The duration is positive if the other instant is before this instant, and negative if after.
  • Temporal/Instant/subtract
    • : Returns a new Temporal.Instant object representing this instant moved backward by a given duration (in a form convertible by Temporal/Duration/from).
  • Temporal/Instant/toJSON
    • : Returns a string representing this instant in the same RFC 9557 format as calling Temporal/Instant/toString. Intended to be implicitly called by JSON.stringify().
  • Temporal/Instant/toLocaleString
    • : Returns a string with a language-sensitive representation of this instant. In implementations with Intl.DateTimeFormat API support, this method delegates to Intl.DateTimeFormat.
  • Temporal/Instant/toString
    • : Returns a string representing this instant in the RFC 9557 format using the specified time zone.
  • Temporal/Instant/toZonedDateTimeISO
    • : Returns a new Temporal.ZonedDateTime object representing this instant in the specified time zone using the ISO 8601 calendar system.
  • Temporal/Instant/until
    • : Returns a new Temporal.Duration object representing the duration from this instant to another instant (in a form convertible by Temporal/Instant/from). The duration is positive if the other instant is after this instant, and negative if before.
  • Temporal/Instant/valueOf

Specifications

Browser compatibility

See also

  • Temporal
  • Temporal.Duration
  • Temporal.ZonedDateTime

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。