Temporal.ZonedDateTime.prototype.startOfDay()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die startOfDay()-Methode von Temporal.ZonedDateTime-Instanzen gibt ein Temporal.ZonedDateTime-Objekt zurück, das den ersten Moment dieses Datums in der Zeitzone darstellt. Es hat normalerweise eine Uhrzeit von 00:00:00, kann aber abweichen, wenn Mitternacht aufgrund von Offset-Änderungen nicht existiert. In diesem Fall wird der erste existierende Zeitpunkt zurückgegeben.

Es ist äquivalent zu einem Aufruf von withPlainTime() ohne Argumente.

Syntax

js
startOfDay()

Parameter

Keine.

Rückgabewert

Ein Temporal.ZonedDateTime-Objekt mit dem Zeitpunkt t, so dass:

  • Das Datum bei t von dem Datum eine Nanosekunde vor t abweicht.
  • Das Datum bei t mit dem Datum von this identisch ist.

Beispiele

Verwendung von 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]"

Spezifikationen

Specification
Temporal proposal
# sec-temporal.zoneddatetime.prototype.startofday

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch