Premiers pas

Utilitaires de calendrier et d’heure locale tenant compte des fuseaux horaires pour Cloudflare Workers. Les Workers manipulent des instants UTC ;
ce package permet à l’application de choisir un fuseau horaire IANA une fois par isolate et gère l’heure d’été
lors des conversions entre instants et dates locales.

Essayez la démonstration de conversion. Nous recommandons d’associer la bibliothèque aux contrôles ESLint pour détecter les utilisations implicites du fuseau horaire.

Installer

npm install @rdlabo/workers-timezone

Démarrage rapide

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

Initialisez une seule fois pendant l’évaluation du module, jamais par requête ni par locataire. Sans initialisation, la valeur par défaut
est Asia/Tokyo ; transmettez un fuseau explicite aux conversions pour un comportement propre à l’utilisateur.

Documentation

• Fuseaux horaires et dates calendaires — configuration, heure d’été et séparation avec la base de données.
• API — conversions, opérations calendaires, types et noms de compatibilité.
• Migration — passage depuis le kit et changements de comportement.

Ces guides décrivent cette révision du code source. Utilisez le tag de version correspondant à la version installée.