Antwort.

Hintergrund der Frage:

Im JavaScript wird das Date-Objekt verwendet, um Daten und Zeiten darzustellen und ist bekannt für seine Besonderheiten in der Arbeit — Mutierbarkeit, Parsing-Komplexität und Zeitzonenmerkmale. TypeScript verwendet für Date die standardmäßigen JS-Typen, jedoch erfordert die Typisierung und Arbeit mit Datum im strengen Code einen besonderen Ansatz.

Problem:

Date in JavaScript ist ein mutierbares Objekt, das nichttypische Fehler verursachen kann (z.B. mutiert setMonth() das Objekt selbst, was zu unerwartetem Verhalten des Codes führen kann). Darüber hinaus erfordert die Integration mit externen Bibliotheken (moment.js, date-fns, Day.js usw.), die Typgenauigkeit zu beachten — z.B. moment.Instant oder spezifische Zeitverpackungen, die nicht miteinander kompatibel sind. Manchmal kann der Rückgabetyp string oder number (Timestamp) sein, was zu Fehlern bei der Typannotation oder bei der Verwendung von APIs führt.

Lösung:

TypeScript typisiert eine neue Instanz von Date als Date, und alle seine Methoden sind verfügbar. Bei der Integration mit anderen Bibliotheken ist es wichtig, die Typen der Eingangs- und Ausgangswerte genau zu überwachen — man sollte eine explizite Typumwandlung zu Date verwenden (z.B. new Date(value)), oder benutzerdefinierte Typcontainer für Datum und Zeit erstellen. Für die Konvertierung zwischen Timestamp (number), String und dem Date-Objekt müssen die Typen strikt angegeben und die Funktionen mit Typen oder Schnittstellen beschrieben werden.

Beispielcode:

function toIsoString(d: Date | number | string): string {
  if (d instanceof Date) return d.toISOString();
  if (typeof d === 'number' || typeof d === 'string') return new Date(d).toISOString();
  throw new Error('Ungültiges Datum');
}

Schlüsselmerkmale:

Date ist ein mutierbares Objekt, kein Werttyp, sondern ein Referenztyp.
Das Entgegennehmen und Zurückgeben von Datum aus einer API oder externen Bibliotheken erfordert eine strikte Einhaltung der Typkompatibilität.
Externe Wrapper wie moment und dayjs erfordern explizit benutzerdefinierte Typen und/oder Type Guard-Funktionen.

Fangfragen.

Ist der Typ "Date" in TypeScript ein einfacher Werttyp?

Nein, Date ist ein Objekt, also ein Referenztyp. Der Vergleich von Daten mit == oder === vergleicht nicht die Werte, sondern nur die Referenzen.

const d1 = new Date('2022-01-01');
const d2 = new Date('2022-01-01');
d1 === d2; // false

Kann man einen String oder eine Zahl direkt dem Typ Date zuweisen, ohne eine neue Initialisierung?

Nein, der Typ Date ist nicht kompatibel mit number oder string. Es muss eine neue Instanz erstellt werden: new Date(value).

const d: Date = new Date('2020-01-01');
// const d2: Date = '2020-01-01'; // Typfehler

Wird eine Funktion, die Date entgegenimmt, mit Objekten aus externen Bibliotheken (moment, dayjs) funktionieren?

Nein, es sei denn, die Bibliothek implementiert explizit die Umwandlung/Zusammenarbeit mit Date über valueOf/toDate, dies sind unterschiedliche Typen, und TypeScript wird sie nicht als Date erkennen.

import dayjs from "dayjs";
function doSomething(d: Date) { /* ... */ }
doSomething(dayjs()); // Fehler, da der Typ Dayjs nicht mit Date kompatibel ist

Typische Fehler und Antipatterns

Verwendung beliebiger Typen (any) für Datum bei der Integration mit APIs.
Mutation des Date-Objekts (set*, setUTC*) beim Übergabe an mehrere Funktionen — Risiko von Race Conditions.
Typinkompatibilität: Versuch, mit einem externen Typ als Date zu arbeiten.

Beispiel aus der Praxis

Negativer Fall

Im Code wurde ein Argument als any akzeptiert, und es wurde davon ausgegangen, dass dies ein Date ist. In der Praxis gab die API einen Timestamp als String zurück, was zu einem Fehler beim Aufruf von .getFullYear() führte.

Vorteile:

Arbeiten "mit allem möglichen" ohne Kompilierungsfehler.

Nachteile:

Risiko von Laufzeitfehlern.
Schwierigkeiten bei der Fehlersuche in der Produktion.

Positiver Fall

Der Entwickler erstellte einen expliziten Typ für den Parameter (Date | string | number), führte Type Guards ein, und die Funktion verwendete explizit new Date. Der Compiler zwingt dazu, alle Typen explizit zu bearbeiten.