Die Methode Date.prototype.getMinutes() gibt die Minute eines Date-Objekts in der lokalen Zeitzone zurück. Der Rückgabewert ist eine Ganzzahl zwischen 0 und 59. Sie ist eine der grundlegenden Komponenten zum Zerlegen einer Uhrzeit in ihre Bestandteile und wird typischerweise in Verbindung mit getHours() und getSeconds() verwendet, um eine vollständige Zeitangabe zu erzeugen.
Funktionsweise
getMinutes() extrahiert ausschließlich die Minutenkomponente einer Date-Instanz. In den meisten Zeitzonen ist der Rückgabewert identisch mit dem von getUTCMinutes(), da die meisten Zonen ganzzahlige Stunden-Offsets verwenden.
Es gibt jedoch Zeitzonen mit halb- oder viertelstündlichem Versatz – etwa Indien (UTC+5:30), Iran (UTC+3:30), Nepal (UTC+5:45) oder Neufundland (UTC-3:30). In diesen Regionen weicht getMinutes() von getUTCMinutes() ab.
Syntax
date.getMinutes()Die Methode erwartet keine Parameter.
Rückgabewert
Eine Ganzzahl zwischen 0 und 59, die die Minute in der lokalen Zeitzone repräsentiert. Bei einem ungültigen Datum wird NaN zurückgegeben.
Beispiele
Minuten auslesen
const date = new Date("2026-05-01T14:30:00");
console.log(date.getMinutes());30Uhrzeit als HH:MM formatieren
function formatTime(date) {
const hh = String(date.getHours()).padStart(2, "0");
const mm = String(date.getMinutes()).padStart(2, "0");
return `${hh}:${mm}`;
}
console.log(formatTime(new Date("2026-05-01T09:05:00")));
console.log(formatTime(new Date("2026-05-01T23:59:00")));09:05
23:59Minute auf Viertelstunde runden
In Buchhaltungs- oder Zeiterfassungs-Systemen wird die aktuelle Zeit häufig auf 15-Minuten-Slots gerundet.
function rundeAufViertelstunde(date) {
const result = new Date(date);
const minuten = result.getMinutes();
result.setMinutes(Math.round(minuten / 15) * 15, 0, 0);
return result;
}
console.log(rundeAufViertelstunde(new Date("2026-05-01T14:38:00")).toLocaleTimeString("de-DE"));
console.log(rundeAufViertelstunde(new Date("2026-05-01T14:07:00")).toLocaleTimeString("de-DE"));14:45:00
14:00:00Minutendifferenz zwischen zwei Zeiten
const a = new Date("2026-05-01T14:30:00");
const b = new Date("2026-05-01T15:45:00");
const diffMs = b.getTime() - a.getTime();
const diffMin = Math.round(diffMs / (1000 * 60));
console.log(`${diffMin} Minuten`);75 MinutenHinweise & verwandte Methoden
- Für eine zeitzonenunabhängige Variante:
Date.prototype.getUTCMinutes(). Wichtig in Zonen mit nicht-stündlichem Offset (z. B. Indien, Iran, Nepal). - Zum Setzen der Minute:
Date.prototype.setMinutes()– kann optional Sekunden und Millisekunden in einem Aufruf setzen. - Bei der Berechnung von Zeitdifferenzen niemals einfach
getMinutes()zweier Daten subtrahieren – das funktioniert nur innerhalb derselben Stunde. Stattdessen übergetTime()rechnen.