Erste Schritte

Zeitzonenbewusste Hilfsfunktionen für Kalenderdaten und lokale Uhrzeiten in Cloudflare Workers. Workers arbeiten mit UTC-Zeitpunkten. Dieses Paket ermöglicht einer Anwendung, einmal pro Isolate eine IANA-Zeitzone zu wählen, und berücksichtigt Sommerzeit beim Konvertieren zwischen Zeitpunkten und lokalen Datumswerten.

Probieren Sie die Konvertierungsdemo aus. Wir empfehlen, die Bibliothek mit ESLint-Prüfungen zu kombinieren, um implizite Zeitzonenverwendung zu erkennen.

Installation

npm install @rdlabo/workers-timezone

Schnellstart

import { TIME_ZONES, initializeTimezone, localDateTimeToInstant, toLocalDateTime } from '@rdlabo/workers-timezone';

initializeTimezone({ timeZone: TIME_ZONES.NEW_YORK });

toLocalDateTime(new Date('2026-07-01T13:00:00Z'));
// '2026-07-01 09:00:00'

localDateTimeToInstant('2026-07-01', '09:00:00');
// 2026-07-01T13:00:00.000Z

Initialisieren Sie einmal während der Modulauswertung, niemals pro Anfrage oder Mandant. Ohne Initialisierung ist der Standard Asia/Tokyo. Übergeben Sie Konvertierungen für nutzerspezifisches Verhalten eine ausdrückliche Zeitzone.

Dokumentation

• Zeitzonen und Kalenderdaten — Konfiguration, Sommerzeit und Datenbankgrenzen.
• API — Konvertierungen, Kalenderoperationen, Typen und Kompatibilitätsnamen.
• Migration — Wechsel vom Kit und Verhaltensänderungen.

Diese Anleitungen beschreiben diese Quellcoderevision. Verwenden Sie für eine installierte Version das passende Release-Tag.