Temporal.PlainDateTime.prototype.minute — Eigenschaft · JavaScript-Referenz

Signatur

get Temporal.PlainDateTime.prototype.minute

Beschreibung

Die Zugriffs-Eigenschaft minute gibt die Minute der Uhrzeit zurück, die in einer Temporal.PlainDateTime-Instanz gespeichert ist. Der Wert ist immer eine ganze Zahl von 0 bis 59. Er hängt nicht vom Kalender ab, denn alle Kalender in Temporal verwenden dieselbe Uhrzeit-Darstellung.

Sie ist nur lesbar: Es gibt einen Getter, aber keinen Setter. PlainDateTime-Objekte sind unveränderlich. Wer die Minute ändern will, erzeugt mit with({ minute: … }) ein neues Objekt. Wer Minuten addieren will, nimmt add({ minutes: … }).

Typische Anwendungen: Uhrzeiten selbst formatieren, Termine auf ein Raster prüfen (zum Beispiel volle Viertelstunden) und Zeitwerte für eigene Logik in ihre Bestandteile zerlegen. Da PlainDateTime keine Zeitzone kennt, ist die Minute immer die „Wanduhr-Minute“, so wie sie beim Erzeugen angegeben wurde.

Rückgabewert

Typ

number

Beschreibung

Ganze Zahl von 0 bis 59: die Minutenkomponente der Uhrzeit.

Beispiele

Minute auslesen

const dt = Temporal.PlainDateTime.from("2024-05-17T14:37:12");
console.log(dt.minute);

37

Neues Objekt mit geänderter Minute (unveränderlich)

const termin = Temporal.PlainDateTime.from("2024-05-17T09:48");

// Zuweisung ändert nichts, strict mode wirft TypeError
// termin.minute = 0;

const korrigiert = termin.with({ minute: 0 });
console.log(termin.minute, korrigiert.minute);
console.log(korrigiert.toString());

48 0 2024-05-17T09:00:00

Prüfen, ob ein Termin auf eine Viertelstunde fällt

const istViertelstunde = (dt) => dt.minute % 15 === 0 && dt.second === 0;

const termine = ["2024-06-01T10:15", "2024-06-01T10:20", "2024-06-01T11:45"]
  .map((s) => Temporal.PlainDateTime.from(s));

for (const t of termine) {
  console.log(t.toString(), istViertelstunde(t));
}

2024-06-01T10:15:00 true 2024-06-01T10:20:00 false 2024-06-01T11:45:00 true

Übertrag beim Addieren von Minuten

const start = Temporal.PlainDateTime.from("2024-12-31T23:50");
const ende = start.add({ minutes: 25 });
console.log(ende.minute, ende.hour, ende.toPlainDate().toString());

15 0 2025-01-01

// Wichtig · Fallstricke

Browser-Unterstützung: Temporal ist noch neu. Firefox unterstützt es ab Version 139, Chrome ab 144. Safari und ältere Umgebungen brauchen ein Polyfill, z. B. @js-temporal/polyfill oder temporal-polyfill. Prüfen lässt sich die Unterstützung mit typeof Temporal !== \"undefined\".
Nur lesbar: Eine Zuweisung an minute wird ohne Fehler ignoriert, im strict mode (auch in ES-Modulen) wirft sie einen TypeError. Für einen neuen Wert with() verwenden.
Überlauf bei with(): with({ minute: 75 }) wird standardmäßig auf 59 begrenzt (overflow: \"constrain\"). Mit { overflow: \"reject\" } wird stattdessen ein RangeError geworfen.
Keine Zeitzone: PlainDateTime kennt keine Zeitzone und keinen Versatz. Brauchen Sie die Minute zu einem bestimmten Zeitpunkt in einer Zone, nehmen Sie Temporal.ZonedDateTime. Bei Zonen mit einem Versatz wie +05:45 kann die Minute dort anders ausfallen.
Nicht verwechseln mit Temporal.Duration.prototype.minutes (Plural): Das ist eine Dauer und kann auch größer als 59 oder negativ sein.

Siehe auch

Temporal.PlainDateTime Temporal.PlainDateTime.prototype.hour Temporal.PlainDateTime.prototype.second Temporal.PlainDateTime.prototype.with() Temporal.PlainDateTime.prototype.add() Temporal.PlainTime.prototype.minute Temporal.ZonedDateTime.prototype.minute