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.

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 die Uhrzeit 00:00:00, kann jedoch anders sein, wenn Mitternacht aufgrund von Offset-Änderungen nicht existiert. In diesem Fall wird die erste existierende Zeit 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 dasselbe ist wie das Datum dieses Objekts.

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