Date.prototype.getMinutes() — Methode · JavaScript-Referenz

Signatur

Date.prototype.getMinutes()

Beschreibung

getMinutes() liest die Minutenkomponente eines Date-Objekts aus. Das Ergebnis ist eine ganze Zahl zwischen 0 und 59. Grundlage ist die lokale Zeitzone der Laufzeitumgebung, also die Systemeinstellung des Browsers oder des Node.js-Prozesses.

Typische Einsatzfälle sind eigene Uhrzeit-Formatierungen (z. B. HH:MM), Zeitraster wie „auf volle Viertelstunde runden“ oder Prüfungen, ob gerade eine volle Stunde begonnen hat. Zusammen mit getHours() und getSeconds() lassen sich die Bestandteile einer Uhrzeit einzeln auswerten.

Wenn du eine zeitzonenunabhängige Auswertung brauchst, zum Beispiel auf dem Server oder für Protokolldaten, nimm besser getUTCMinutes(). Für Anzeigen in bestimmten Zeitzonen ist Intl.DateTimeFormat meist die bessere Wahl.

Rückgabewert

Typ

number

Beschreibung

Ganze Zahl von 0 bis 59 mit den Minuten in Ortszeit, oder NaN, wenn das Datum ungültig ist.

Beispiele

Minuten eines festen Datums auslesen

const termin = new Date(2024, 2, 15, 14, 37, 12); // 15. März 2024, 14:37:12 Ortszeit
console.log(termin.getMinutes());

37

Uhrzeit als HH:MM formatieren

const formatZeit = (datum) => {
  const h = String(datum.getHours()).padStart(2, '0');
  const m = String(datum.getMinutes()).padStart(2, '0');
  return `${h}:${m}`;
};

console.log(formatZeit(new Date(2024, 0, 1, 9, 5)));

09:05

Auf die nächste Viertelstunde aufrunden

const naechsteViertelstunde = (datum) => {
  const d = new Date(datum);
  const rest = d.getMinutes() % 15;
  if (rest !== 0 || d.getSeconds() || d.getMilliseconds()) {
    d.setMinutes(d.getMinutes() + (15 - rest), 0, 0);
  }
  return d;
};

const slot = naechsteViertelstunde(new Date(2024, 4, 10, 10, 52, 30));
console.log(slot.getHours(), slot.getMinutes());

11 0

Ungültiges Datum erkennen

const kaputt = new Date('kein Datum');
const minuten = kaputt.getMinutes();
console.log(Number.isNaN(minuten) ? 'Ungültiges Datum' : minuten);

Ungültiges Datum

// Wichtig · Fallstricke

Abhängig von der Zeitzone: Das Ergebnis richtet sich nach der Systemzeitzone. Bei Zeitzonen mit halben oder Viertelstunden-Versatz (z. B. Indien UTC+5:30, Nepal UTC+5:45) unterscheidet sich getMinutes() von getUTCMinutes(). Für einheitliche Werte über Zeitzonen hinweg getUTCMinutes() verwenden.
Ungültige Daten: Bei einem ungültigen Date kommt NaN zurück, es wird kein Fehler geworfen. Vor der Formatierung prüfen, sonst erscheint z. B. "NaN" in der Ausgabe.
Keine führende Null: Für die Anzeige ist String(m).padStart(2, '0') nötig, sonst erhältst du z. B. 9:5 statt 09:05.
Parsen von Datumsstrings: new Date('2024-03-15') (nur Datum) wird als UTC gelesen, new Date('2024-03-15T14:37') dagegen als Ortszeit. Das kann Stunden und Minuten unerwartet verschieben.
Wird die Methode auf einem Objekt aufgerufen, das kein Date ist, wirft sie einen TypeError.
Seit ES1 in allen Browsern und in Node.js verfügbar. Für neuen Code kommt künftig auch die Temporal-API infrage (Eigenschaft minute).

Siehe auch

Date.prototype.getUTCMinutes() Date.prototype.setMinutes() Date.prototype.getHours() Date.prototype.getSeconds() Date Intl.DateTimeFormat