When adding or subtracting time, DST transitions are handled automatically.

Spring Forward (Gap)

In North America, on March 8, 2026, at 2:00 AM EST, clocks spring forward to 3:00 AM EDT.

import { difference, shift, toInstant, toZoned } from '@vielzeug/timit';

// One hour before the transition
const before = Temporal.ZonedDateTime.from('2026-03-08T01:30:00-05:00[America/New_York]');

// Add 1 hour — should jump to 3:30 EDT (not 2:30)
const after = shift(before, { hours: 1 });

console.log(after.toString());
// → 2026-03-08T03:30:00-04:00[America/New_York]

Fall Back (Overlap)

In North America, on November 1, 2026, at 2:00 AM EDT, clocks fall back to 1:00 AM EST. The hour from 1:00–2:00 AM happens twice.

// First occurrence: 1:30 AM EDT
const first = toInstant(Temporal.ZonedDateTime.from('2026-11-01T01:30:00-04:00[America/New_York]'));

// Convert to different representation
const zoned = toZoned(first, { tz: 'America/New_York', when: 'earlier' });
console.log(zoned.toString());
// → 2026-11-01T01:30:00-04:00[America/New_York] (EDT, first occurrence)

Why This Matters

Without DST awareness, you'd calculate incorrect times:

// ❌ Wrong: Naive millisecond math
const wrongReminder = new Date(meeting.getTime() - 30 * 60_000);

// ✅ Correct: Timit handles DST
const rightReminder = shift(meeting, { minutes: -30 }, { tz: 'America/New_York' });

Compare Instants Across DST

const beforeDst = Temporal.ZonedDateTime.from('2026-03-08T01:30:00-05:00[America/New_York]');
const afterDst = Temporal.ZonedDateTime.from('2026-03-08T04:00:00-04:00[America/New_York]');

const duration = difference(beforeDst, afterDst, { tz: 'America/New_York' });
console.log(duration.toString()); // PT2H30M — correct!