Internationalization

Pass any BCP-47 locale tag. Date and time formats come from the browser’s Intl API — no locale bundles to ship. UI strings are built in for English and Chinese, and trivially extensible for anything else.

What the locale controls

• Month/day/weekday names, title formats and time labels (via Intl.DateTimeFormat).
• The default first day of week (via Intl.Locale weekInfo, with a safe fallback) — override with firstDayOfWeek.
• 12/24-hour clock — override with hour12.
• Built-in UI strings for 10 languages: en, zh, de, fr, es, pt, ja, ko, ru, it — anything else falls back to English (override via messages).

Custom UI strings

import type { CalendarMessages } from 'svelte5plus-calendar';

// Add a locale (or override single strings) via the messages prop:
const de: Partial<CalendarMessages> = {
  today: 'Heute',
  day: 'Tag',
  week: 'Woche',
  month: 'Monat',
  year: 'Jahr',
  agenda: 'Agenda',
  allDay: 'Ganztägig',
  more: (n) => `+${n} weitere`,
  noEvents: 'Keine Termine'
};

Then pass them to the component: <Calendar locale="de" messages={de} />

Display time zone

Pass an IANA zone via the timeZone prop to render the whole calendar in that zone. Event Dates remain real instants — the grid, popovers, quick-create and drag edits are all displayed and interpreted in the target zone, and edited values are converted back automatically.