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

浏览器兼容性

另见