Temporal.ZonedDateTime.prototype.minute

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 minute Accessor-Eigenschaft von Temporal.ZonedDateTime-Instanzen gibt eine ganze Zahl von 0 bis 59 zurück, die die Minutenkomponente dieser Zeit darstellt.

Der Set-Accessor von minute 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.minute.

Für ZonedDateTime kann minute aufgrund von Offset-Änderungen nicht kontinuierlich sein. Obwohl dies seltener vorkommt als Änderungen der hour (da Zeitumstellungen normalerweise um ganze Stunden erfolgen), kann es dennoch auftreten.

Beispiele

Verwendung von minute

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

Nicht kontinuierliche Minute

Typischerweise verläuft minute immer von 0 bis 59 und dann wieder zurück zu 0, selbst beim Durchlaufen einer Sommerzeitumstellung. Es gibt einen speziellen Fall, in dem Sommerzeit eine 30-minütige Verschiebung hat: die Lord-Howe-Insel in Australien, die zwischen +10:30 und +11:00 wechselt. In diesem Fall kann die Minute nicht kontinuierlich sein.

js
const dt = Temporal.ZonedDateTime.from(
  "2021-10-03T01:59:00+10:30[Australia/Lord_Howe]",
);
console.log(dt.minute); // 59
const dt2 = dt.add({ minutes: 1 });
console.log(dt2.minute); // 30
console.log(dt2.toString()); // 2021-10-03T02:30:00+11:00[Australia/Lord_Howe]

Es gibt einen zweiten ungewöhnlichen Fall, in dem die Minute nicht kontinuierlich sein kann: die Standardisierung der stündlichen Zeitzonen. Im frühen 20. Jahrhundert verwendeten die meisten Länder ihre eigenen Zeitzonen, die oft keine volle Stunde von UTC abwichen. Zum Beispiel hatte Paris früher einen Offset von UTC+0:09:21, der am 11. März 1911 auf UTC+0 geändert wurde.

js
const dt = Temporal.ZonedDateTime.from(
  "1911-03-10T23:59:00+00:09:21[Europe/Paris]",
);
console.log(dt.minute); // 59
const dt2 = dt.add({ minutes: 1 });
console.log(dt2.minute); // 50
console.log(dt2.toString()); // 1911-03-10T23:50:39+00:00[Europe/Paris]

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch