Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 Zeitpunkt dieses Datums in der Zeitzone darstellt. Es hat normalerweise eine Uhrzeit von 00:00:00, kann aber anders sein, wenn Mitternacht aufgrund von Offset-Änderungen nicht existiert. In diesem Fall wird die erste existierende Uhrzeit zurückgegeben.

Es ist gleichbedeutend mit dem Aufruf von withPlainTime() ohne Argumente.

Syntax

js
startOfDay()

Parameter

Keine.

Rückgabewert

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

  • Das Datum bei t sich von dem Datum eine Nanosekunde vor t unterscheidet.
  • Das Datum bei t mit dem Datum von this übereinstimmt.

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
# sec-temporal.zoneddatetime.prototype.startofday

Browser-Kompatibilität

Siehe auch