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

Signatur

get Temporal.PlainTime.prototype.minute

Beschreibung

Die Zugriffs-Eigenschaft minute gibt die Minute einer Uhrzeit ohne Datum und ohne Zeitzone (Temporal.PlainTime) zurück. Der Wert ist immer eine ganze Zahl im Bereich 0 bis 59.

Die Eigenschaft ist schreibgeschützt: Sie hat nur einen Getter und keinen Setter. Temporal.PlainTime-Objekte sind unveränderlich. Wenn du die Minute ändern willst, erzeugst du mit with({ minute: … }) eine neue Instanz, oder du rechnest mit add() bzw. subtract().

Typische Einsatzfälle sind das Formatieren von Uhrzeiten, das Prüfen von Zeitfenstern (z. B. „zur vollen Stunde“ oder „jede Viertelstunde“) und das Zerlegen von Zeitangaben in einzelne Bestandteile. Anders als bei Date.prototype.getMinutes() spielt hier keine lokale Zeitzone hinein. Du bekommst genau den Wert, mit dem die Instanz angelegt wurde.

Rückgabewert

Typ

number

Beschreibung

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

Beispiele

Minute aus einer Uhrzeit auslesen

const zeit = Temporal.PlainTime.from('14:37:12');
console.log(zeit.minute);

const mitternacht = new Temporal.PlainTime(0, 0);
console.log(mitternacht.minute);

37 0

Minute ändern – neue Instanz mit with()

const start = Temporal.PlainTime.from('09:05');
// start.minute = 30; // hat keine Wirkung (TypeError im strict mode)
const halb = start.with({ minute: 30 });
console.log(start.minute, halb.minute);
console.log(halb.toString());

5 30 09:30:00

Viertelstunden-Takt prüfen und Überlauf beachten

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

const termine = ['10:00', '10:15', '10:20', '10:45'].map((s) => Temporal.PlainTime.from(s));
console.log(termine.filter(istViertelstunde).map(String));

// add() läuft über die Stunde hinaus, minute bleibt 0–59
const spaeter = Temporal.PlainTime.from('10:50').add({ minutes: 25 });
console.log(spaeter.hour, spaeter.minute);

[ '10:00:00', '10:15:00', '10:45:00' ] 11 15

// Wichtig · Fallstricke

Browserunterstützung: Temporal ist erst in neueren Browsern verfügbar (Firefox ab 139, Chromium-Browser ab 144). Safari und ältere Node.js-Versionen unterstützen es teilweise nicht. Für diese Umgebungen brauchst du einen Polyfill wie @js-temporal/polyfill oder temporal-polyfill.
Schreibgeschützt: Eine Zuweisung an minute wird im sloppy mode stillschweigend ignoriert und löst im strict mode einen TypeError aus. Nutze stattdessen with().
Keine führende Null: Der Rückgabewert ist eine Zahl. Für eine zweistellige Ausgabe verwendest du String(t.minute).padStart(2, '0'), toString() oder toLocaleString().
Überlauf: Temporal.PlainTime.from({ minute: 75 }) begrenzt den Wert standardmäßig auf 59 (overflow: 'constrain'). Mit { overflow: 'reject' } wird stattdessen ein RangeError ausgelöst.
Wenn du den Getter auf einem Objekt aufrufst, das keine PlainTime ist, gibt es einen TypeError.

Siehe auch

Temporal.PlainTime Temporal.PlainTime.prototype.hour Temporal.PlainTime.prototype.second Temporal.PlainTime.prototype.with() Temporal.PlainTime.prototype.add() Date.prototype.getMinutes()