timeZone
The IANA zone the calendar draws its days and hours in.
| Type | ZoneId — string |
|---|---|
| Default | the browser's time zone — said once (zone-from-browser) |
Live update (update()) | Yes |
| Declared in | packages/core/src/kernel.ts |
What it does
Section titled “What it does”Every event keeps its own zone: 2026-10-22T10:00[America/Chicago] is ten
o’clock in Chicago, whatever the calendar shows. timeZone decides where
that moment falls on screen — at 17:00 in a calendar set to
'Europe/Paris', at 10:00 in one set to 'America/Chicago'. Days are that
zone’s days: a day of 23 or 25 hours when its clocks change.
Give an IANA name ('Europe/Paris', 'Africa/Algiers', 'UTC'), never a
bare offset: an offset has no clock changes. Left out, the calendar uses the
browser’s zone and says so once (zone-from-browser, through onProblem or
the console) — a phone set to Tokyo would draw Algiers’ 14:00 at 22:00. Pass
Temporal.Now.timeZoneId() when the browser’s zone is what you mean.
Example
Section titled “Example”import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, { timeZone: 'Europe/Paris', events: [{ id: 'call', title: 'Call Chicago', start: '2026-10-22T10:00[America/Chicago]', duration: { hours: 1 } }],});
// Later: the same events, drawn in Chicago's hours.calendar.update({ timeZone: 'America/Chicago' });import { Component, signal } from '@angular/core';import { DZ_CALENDAR } from '@dzcalendar/angular';
@Component({ selector: 'app-agenda', imports: [DZ_CALENDAR], template: ` <select (change)="zone.set($any($event.target).value)"> <option value="Europe/Paris">Paris</option> <option value="America/Chicago">Chicago</option> </select> <dz-calendar [timeZone]="zone()" />`,})export class Agenda { readonly zone = signal('Europe/Paris');}import { useState } from 'react';import { DzCalendar } from '@dzcalendar/react';
export function Agenda() { const [zone, setZone] = useState('Europe/Paris'); return ( <> <select value={zone} onChange={(e) => setZone(e.target.value)}> <option value="Europe/Paris">Paris</option> <option value="America/Chicago">Chicago</option> </select> <DzCalendar timeZone={zone} /> </> );}<script setup lang="ts">import { ref } from 'vue';import { DzCalendar } from '@dzcalendar/vue';
const zone = ref('Europe/Paris');</script>
<template> <select v-model="zone"> <option value="Europe/Paris">Paris</option> <option value="America/Chicago">Chicago</option> </select> <DzCalendar :time-zone="zone" /></template>In the frameworks it is an input: Angular’s timeZone, React’s timeZone, Vue’s time-zone.
Live demo
Section titled “Live demo”The call is set at 10:00 in Chicago; the calendar, in Paris, draws it at 17:00.
See also
Section titled “See also”initialDate— its “today” is in this zone.businessHours— hours read in this zone unless a rule names its own.- Time zones and clock changes.