Temporal.ZonedDateTime.prototype.hour

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 hour Accessor-Eigenschaft von Temporal.ZonedDateTime-Instanzen gibt eine Ganzzahl von 0 bis 23 zurück, die die Stundenkomponente dieser Zeit darstellt.

Der Set-Accessor von hour ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die with()-Methode, um ein neues Temporal.ZonedDateTime-Objekt mit dem gewünschten neuen Wert zu erstellen.

Für allgemeine Informationen und weitere Beispiele siehe Temporal.PlainTime.prototype.hour.

Für ZonedDateTime kann hour aufgrund von Offset-Änderungen wie den Übergängen zur Sommerzeit nicht kontinuierlich sein. In diesem Fall kann die Stunde wiederholt oder übersprungen werden.

Beispiele

Verwendung von hour

js
const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56.123456789-04:00[America/New_York]",
);
console.log(dt.hour); // 12

Nicht-kontinuierliche Stunde

Nicht-kontinuierliche Stunde ist aufgrund von Sommerzeitübergängen sehr häufig, was im Abschnitt Mehrdeutigkeit und Lücken von Ortszeit zu UTC-Zeit genauer erklärt wird.

js
const dt = Temporal.ZonedDateTime.from(
  "2024-11-03T01:59:00-04:00[America/New_York]",
);
console.log(dt.hour); // 1
const dt2 = dt.add({ minutes: 1 });
console.log(dt2.hour); // 1
console.log(dt2.toString()); // 2024-11-03T01:00:00-05:00[America/New_York]

const dt3 = Temporal.ZonedDateTime.from(
  "2024-03-10T01:59:00-05:00[America/New_York]",
);
console.log(dt3.hour); // 1
const dt4 = dt3.add({ minutes: 1 });
console.log(dt4.hour); // 3
console.log(dt4.toString()); // 2024-03-10T03:00:00-04:00[America/New_York]

Aus diesem Grund sollten Sie immer add() und subtract() bevorzugen, um Daten und Zeiten zu manipulieren, anstatt die hour-Eigenschaft direkt zu ändern.

Spezifikationen

Specification
Temporal proposal
# sec-get-temporal.zoneddatetime.prototype.hour

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch