1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
import { describe, expect, it } from "vitest";
import { formatUtcOffset, isValidTimeZone, nextOffsetTransition, utcOffsetSeconds } from "../src/timezone.js";
describe("isValidTimeZone", () => {
it("accepts IANA names", () => {
expect(isValidTimeZone("America/Chicago")).toBe(true);
expect(isValidTimeZone("Europe/Berlin")).toBe(true);
expect(isValidTimeZone("UTC")).toBe(true);
});
it("rejects invalid names", () => {
expect(isValidTimeZone("Central Time")).toBe(false);
expect(isValidTimeZone("")).toBe(false);
expect(isValidTimeZone("America/Springfield")).toBe(false);
});
});
describe("utcOffsetSeconds", () => {
it("returns CST offset in January", () => {
expect(utcOffsetSeconds("America/Chicago", new Date("2026-01-15T12:00:00Z"))).toBe(-6 * 3600);
});
it("returns CDT offset in July", () => {
expect(utcOffsetSeconds("America/Chicago", new Date("2026-07-15T12:00:00Z"))).toBe(-5 * 3600);
});
it("returns 0 for UTC", () => {
expect(utcOffsetSeconds("UTC", new Date("2026-07-15T12:00:00Z"))).toBe(0);
});
it("handles half-hour offsets", () => {
expect(utcOffsetSeconds("Asia/Kolkata", new Date("2026-07-15T12:00:00Z"))).toBe(5.5 * 3600);
});
});
describe("formatUtcOffset", () => {
it("formats negative, positive, and zero offsets", () => {
expect(formatUtcOffset(-6 * 3600)).toBe("UTC-06:00");
expect(formatUtcOffset(5.5 * 3600)).toBe("UTC+05:30");
expect(formatUtcOffset(0)).toBe("UTC+00:00");
});
});
describe("nextOffsetTransition", () => {
it("finds the exact spring-forward instant for Chicago", () => {
const transition = nextOffsetTransition("America/Chicago", new Date("2026-01-15T00:00:00Z"));
expect(transition).not.toBeNull();
// 2026-03-08 02:00 CST (UTC-6) -> 03:00 CDT (UTC-5): 08:00:00 UTC.
expect(transition!.at.toISOString()).toBe("2026-03-08T08:00:00.000Z");
expect(transition!.offsetBeforeSeconds).toBe(-6 * 3600);
expect(transition!.offsetAfterSeconds).toBe(-5 * 3600);
});
it("finds the exact fall-back instant for Chicago", () => {
const transition = nextOffsetTransition("America/Chicago", new Date("2026-07-15T00:00:00Z"));
expect(transition).not.toBeNull();
// 2026-11-01 02:00 CDT (UTC-5) -> 01:00 CST (UTC-6): 07:00:00 UTC.
expect(transition!.at.toISOString()).toBe("2026-11-01T07:00:00.000Z");
expect(transition!.offsetBeforeSeconds).toBe(-5 * 3600);
expect(transition!.offsetAfterSeconds).toBe(-6 * 3600);
});
it("returns null for fixed-offset zones", () => {
expect(nextOffsetTransition("UTC", new Date("2026-01-15T00:00:00Z"))).toBeNull();
});
});
|
