Temporal.ZonedDateTime.prototype.startOfDay()

可用性有限

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

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

Temporal.ZonedDateTime 例項的 startOfDay() 方法返回一個 Temporal.ZonedDateTime 物件,表示此日期在時區中的第一個瞬間。它通常具有 00:00:00 的時間,但如果由於偏移量變化而導致午夜不存在,則可能有所不同,在這種情況下將返回存在的第一個時間。

它等同於不帶引數呼叫 withPlainTime()

語法

js
startOfDay()

引數

無。

返回值

一個 Temporal.ZonedDateTime 物件,其瞬間 t 滿足:

  • t 處的日期與 t 之前一納秒的日期不同。
  • t 處的日期與 this 的日期相同。

示例

使用 startOfDay()

js
// In the US, DST transitions happen at 2am, so the midnight exists
const dt = Temporal.ZonedDateTime.from(
  "2024-03-10T12:00:00-04:00[America/New_York]",
);
console.log(dt.startOfDay().toString()); // "2024-03-10T00:00:00-05:00[America/New_York]"

// In Brazil, DST transitions happened at midnight, so the midnight didn't exist
const dt2 = Temporal.ZonedDateTime.from(
  "2015-10-18T12:00-02:00[America/Sao_Paulo]",
);
console.log(dt2.startOfDay().toString()); // "2015-10-18T01:00:00-02:00[America/Sao_Paulo]"

規範

規範
Temporal
# sec-temporal.zoneddatetime.prototype.startofday

瀏覽器相容性

另見