World Clock
A live digital clock for a chosen IANA time zone, with optional weekday/date display and font, size, and color customization. It needs no data source.
At a glance
| Type key | world-clock |
| Default size | 3 × 4 (min 2 × 3) |
| Data source | None (dataless) |
| Emits | — |
| Receives | — |
| Source | src/widgets/widgets/world-clock/ |
Configuration
| Field | Type | Default | Purpose |
|---|---|---|---|
timeZone | string | "" | IANA zone id (e.g. America/New_York). Empty uses the viewer's local zone. |
hourCycle | "12" | "24" | "12" | 12-hour (AM/PM) or 24-hour readout. |
showTimeZoneLabel | boolean | false | Show the zone name above the time. |
timeZoneLabel | string | "" | Override for the zone label. Empty auto-derives it. |
showSeconds | boolean | true | Show seconds (ticks every 1 s; otherwise every 15 s). |
showDayOfWeek | boolean | false | Show the weekday name below the time. |
showDate | boolean | false | Show the calendar date below the time. |
fontFamily | "sans" | "mono" | "serif" | "sans" | Font preset. |
fontSize | number (16–160 px) | 48 | Time readout size. |
color | string? | — | CSS hex color; omitted uses the theme default. |
Config panel
- Data — none (this widget is dataless).
- Appearance — time zone picker, 12/24-hour toggle, zone label options, seconds/weekday/date toggles, font family, font size slider, and color.
Cross-widget actions
None.
Notable behavior
- The clock ticks live: every 1 s when seconds are shown, every 15 s otherwise.
- The zone label is auto-humanized (e.g.
America/New_York→ "New York") unless overridden.