The Temporal.Now.zonedDateTimeISO() static method returns the current date and time as a Temporal.ZonedDateTime object, in the ISO 8601 calendar and the specified time zone.
Syntax
Temporal.Now.zonedDateTimeISO()
Temporal.Now.zonedDateTimeISO(timeZone)
Parameters
timeZone- : Either a string or a Temporal.ZonedDateTime instance representing the time zone to interpret the system time in. If a
Temporal.ZonedDateTimeinstance, its time zone is used. If a string, it can be a named time zone identifier, an offset time zone identifier, or a date-time string containing a time zone identifier or an offset (see time zones and offsets for more information).
- : Either a string or a Temporal.ZonedDateTime instance representing the time zone to interpret the system time in. If a
Return value
The current date and time in the specified time zone, as a Temporal.ZonedDateTime object using the ISO 8601 calendar. Has the same precision as Temporal/Now/instant.
Exceptions
- RangeError
- : Thrown if the time zone is invalid.
Examples
Using Temporal.Now.zonedDateTimeISO()
// The current date and time in the system's time zone
const dateTime = Temporal.Now.zonedDateTimeISO();
console.log(dateTime); // e.g.: 2021-10-01T06:12:34.567890123+03:00[Africa/Nairobi]
// The current date and time in the "America/New_York" time zone
const dateTimeInNewYork = Temporal.Now.zonedDateTimeISO("America/New_York");
console.log(dateTimeInNewYork); // e.g.: 2021-09-30T23:12:34.567890123-04:00[America/New_York]
Specifications
Browser compatibility
See also
- Temporal.Now
- Temporal.ZonedDateTime
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
