Repository Public
1/**2 * Fuseau horaire des rendez-vous : America/Toronto (heure de l'Est), avec gestion3 * exacte des changements d'heure via la base tz du moteur (Intl). Tous les instants4 * sont stockés en UTC (millisecondes) ; les heures de travail sont en heure locale.5 */6export const TZ = "America/Toronto";78const partsFmt = new Intl.DateTimeFormat("en-CA", {9 timeZone: TZ,10 hourCycle: "h23",11 year: "numeric",12 month: "2-digit",13 day: "2-digit",14 hour: "2-digit",15 minute: "2-digit",16 second: "2-digit",17 weekday: "short",18});19const WD: Record<string, number> = { Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6, Sun: 7 };2021export interface LocalTime {22 date: string; // AAAA-MM-JJ23 minutes: number; // minutes depuis minuit (heure locale)24 weekday: number; // 1 = lundi … 7 = dimanche25}2627export function utcToLocal(ms: number): LocalTime {28 const p: Record<string, string> = {};29 for (const part of partsFmt.formatToParts(new Date(ms))) p[part.type] = part.value;30 return {31 date: `${p.year}-${p.month}-${p.day}`,32 minutes: Number(p.hour) * 60 + Number(p.minute),33 weekday: WD[p.weekday],34 };35}3637/** Décalage (ms) entre l'heure locale et l'UTC à un instant donné (négatif à l'ouest). */38function offsetAt(ms: number): number {39 const p: Record<string, string> = {};40 for (const part of partsFmt.formatToParts(new Date(ms))) p[part.type] = part.value;41 const asUtc = Date.UTC(Number(p.year), Number(p.month) - 1, Number(p.day), Number(p.hour), Number(p.minute), Number(p.second));42 return asUtc - Math.floor(ms / 1000) * 1000;43}4445/**46 * Heure locale → instant UTC. Renvoie null si l'heure n'existe pas (saut du printemps,47 * p. ex. 02:30 le jour du passage à l'heure avancée). Heure ambiguë (automne) : première occurrence.48 */49export function localToUtc(date: string, minutes: number): number | null {50 const [y, m, d] = date.split("-").map(Number);51 const guess = Date.UTC(y, m - 1, d, 0, minutes);52 const candidates = [guess - offsetAt(guess - 6 * 3600_000), guess - offsetAt(guess + 6 * 3600_000)].sort((a, b) => a - b);53 for (const c of candidates) {54 const back = utcToLocal(c);55 if (back.date === date && back.minutes === minutes) return c;56 }57 return null;58}5960export function addDays(date: string, n: number): string {61 const [y, m, d] = date.split("-").map(Number);62 return new Date(Date.UTC(y, m - 1, d + n)).toISOString().slice(0, 10);63}6465export function weekdayOf(date: string): number {66 const [y, m, d] = date.split("-").map(Number);67 const wd = new Date(Date.UTC(y, m - 1, d)).getUTCDay();68 return wd === 0 ? 7 : wd;69}7071export function todayLocal(now = Date.now()): string {72 return utcToLocal(now).date;73}7475/** Début (UTC) d'un jour local ; à minuit le saut d'heure n'arrive jamais à Toronto. */76export function startOfLocalDay(date: string): number {77 return localToUtc(date, 0) ?? Date.UTC(...(date.split("-").map(Number) as [number, number, number]));78}7980const longDate = new Intl.DateTimeFormat("fr-CA", { timeZone: TZ, weekday: "long", day: "numeric", month: "long", year: "numeric" });81const shortDate = new Intl.DateTimeFormat("fr-CA", { timeZone: TZ, day: "numeric", month: "short" });82const time = new Intl.DateTimeFormat("fr-CA", { timeZone: TZ, hour: "numeric", minute: "2-digit", hourCycle: "h23" });83const tzName = new Intl.DateTimeFormat("fr-CA", { timeZone: TZ, timeZoneName: "short" });8485export function fmtDate(ms: number): string {86 return longDate.format(new Date(ms));87}88export function fmtShortDate(ms: number): string {89 return shortDate.format(new Date(ms));90}91export function fmtTime(ms: number): string {92 return time.format(new Date(ms)).replace(":", " h ");93}94export function fmtTzAbbr(ms: number): string {95 return tzName.formatToParts(new Date(ms)).find((p) => p.type === "timeZoneName")?.value ?? "HE";96}97export function fmtDateTime(ms: number): string {98 return `${fmtDate(ms)} à ${fmtTime(ms)} (${fmtTzAbbr(ms)})`;99}100export function minutesLabel(min: number): string {101 return `${String(Math.floor(min / 60)).padStart(2, "0")}:${String(min % 60).padStart(2, "0")}`;102}103