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 Zugriffs-Property von Temporal.ZonedDateTime Instanzen gibt eine ganze Zahl von 0 bis 23 zurück, die die Stundenkomponente dieser Zeit darstellt.

Die Set-Zugriffs-Property 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.

Bei ZonedDateTime kann hour aufgrund von Offset-Änderungen wie Sommerzeitumstellungen 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 sehr häufig aufgrund von Sommerzeitumstellungen, was mehr im Abschnitt Uneindeutigkeit und Lücken von lokaler Zeit zu UTC-Zeit 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 Datum und Zeit zu manipulieren, anstatt die hour Eigenschaft direkt zu ändern.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch