WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Date — Zeitstempel und das UTC-Jahr

Date speichert einen Zeitstempel. Erfahre, wie du das UTC-Jahr ausliest und änderst, wie die Objektmutation funktioniert und wie Datumswerte normalisiert werden – etwa wenn der 29. Februar in ein Nichtschaltjahr fällt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])

Date ist ein integriertes ECMAScript-Objekt, das Millisekunden seit 1970-01-01T00:00:00.000Z speichert oder bei einem ungültigen Datum NaN. Es speichert keine Zeitzone. Lokale Methoden interpretieren denselben Zeitstempel anhand der Zeitzone der Umgebung; UTC-Methoden verwenden UTC.

Date.prototype.getUTCFullYear() gibt das vollständige UTC-Jahr zurück oder bei einem ungültigen Datum NaN. Date.prototype.setUTCFullYear(year[, month[, day]]) verändert das Objekt und gibt den resultierenden Zeitstempel zurück, kein Date-Objekt. Monate verwenden die Indizes 0–11, während die Tage des Monats bei 1 beginnen. Ist das ursprüngliche Datum gültig, verwendet die Methode für jedes weggelassene Monats- oder Tagesargument den bisherigen UTC-Wert als Eingabe. Durch die Normalisierung können sich Monat und Tag im Ergebnis ändern. Ist das Ergebnis gültig, bleibt die UTC-Uhrzeit unverändert.

Der Setter normalisiert Werte: Wird der 29. Februar auf ein Nichtschaltjahr gesetzt, ergibt sich der 1. März. Ein Jahr von 0–99 wird wörtlich interpretiert, anders als beim mehrargumentigen Date-Konstruktor. Bei einem ungültigen Datum verwendet der Setter den Zeitstempel 0 als Ausgangspunkt; ungültige numerische Argumente können dennoch NaN ergeben.

Das Beispiel verwendet ein explizites Z und UTC-Methoden, damit das Ergebnis nicht von der lokalen Zeitzone abhängt. Außerdem wird geprüft, ob der zurückgegebene Zeitstempel mit dem veränderten Objekt übereinstimmt.

Beispiele

const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());

Ergebnis

2024
2025-03-01T12:00:00.000Z
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen