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 |
浏览器兼容性
加载中…
另见
Temporal.ZonedDateTime
Temporal.ZonedDateTime.prototype.with()
Temporal.ZonedDateTime.prototype.add()
Temporal.ZonedDateTime.prototype.subtract()
Temporal.ZonedDateTime.prototype.hour
Temporal.ZonedDateTime.prototype.hoursInDay
Temporal.ZonedDateTime.prototype.timeZoneId
Temporal.ZonedDateTime.prototype.getTimeZoneTransition()