Temporal.Now.zonedDateTimeISO()

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

Temporal.Now.zonedDateTimeISO() 靜態方法以 ISO 8601 日曆和指定時區,將當前日期和時間作為 Temporal.ZonedDateTime 物件返回。

語法

js
Temporal.Now.zonedDateTimeISO()
Temporal.Now.zonedDateTimeISO(timeZone)

引數

timeZone 可選

可以是代表解釋系統時間的時區的字串或 Temporal.ZonedDateTime 例項。如果是 Temporal.ZonedDateTime 例項,則使用其時區。如果是字串,可以是命名時區識別符號、偏移時區識別符號,或包含時區識別符號或偏移量的日期時間字串(有關更多資訊,請參閱 時區和偏移量)。

返回值

以指定時區表示的當前日期和時間,作為使用 ISO 8601 日曆的 Temporal.ZonedDateTime 物件。其精度與 Temporal.Now.instant() 相同。

異常

RangeError

如果時區無效,則丟擲此異常。

示例

使用 Temporal.Now.zonedDateTimeISO()

js
// 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]

規範

規範
Temporal
# sec-temporal.now.zoneddatetimeiso

瀏覽器相容性

另見