Clock widget
Shows the current time in any time zone. Four layouts (digital, analog, combined and world clock), 12/24-hour or custom token formats, locale dates, DST-aware offsets, and auto-scaling text that fills the card at any size. Needs no datasource.
Clock widget
Shows the current time in any time zone — as a digital readout, an analog dial, both together, or a world clock listing several zones. It reads the clock of the machine the dashboard is open on, so it runs live without any device or telemetry.
Data keys
None. This is a static widget with no datasource: leave the data tab empty.
Layouts
Digital · Analog · Analog + digital · World clock
Settings
Layout — pick the layout; Analog and digital arrangement places the dial beside or above the time in the combined layout; Horizontal alignment and Vertical alignment position the clock in the card; Scale the clock to fill the card measures the clock and scales it to Fill this much of the card (default 92%), so one configuration looks right at every widget size.
Time zone — Take the time zone from the viewer’s browser, the dashboard time window, or a fixed Time zone; pick Other to type any IANA time zone name. DST is automatic, including half-hour and 45-minute offsets. An unknown zone falls back to the browser zone.
Time format — Clock is 12 or 24-hour, Show seconds adds seconds, Blink the separator
every second flashes the :. Use a custom time pattern replaces those with your own Custom
time pattern.
Date and time zone label — Show the date with a Date format (full, long, medium, short, weekday, ISO, or a Custom date pattern). Show a time zone label where Label shows the city, short name, long name, or UTC offset. Place the date and label below, above, left, or right of the time; the analog layout always puts them under the dial.
Fonts and colours — Time font and Time colour cover the time, the dial numerals and the world clock rows; Date font and Date colour cover the date, the zone label and AM/PM.
Analog dial — Dial fill, Border and ticks, Ticks (minutes and hours, hours, quarters, none), Numerals (1–12, I–XII, quarters, none), Hour and minute hands, Second hand (sweeping, stepping, none) and Second hand colour.
World clock — Time zones lists the rows, each with its own Time zone and an optional Row
label. Show the difference from the main zone prints +3h / −4h / same time against the zone
set above and flags rows on another calendar day; Show the date on every row and Divider between
rows control the rest.
Format tokens
For both custom patterns. Square brackets pass text through, so HH[h]mm gives 14h09.
| Tokens | Renders |
|---|---|
YYYY YY | 2026, 26 |
MMMM MMM MM M | August, Aug, 08, 8 |
DD D dddd ddd | 18, 18, Tuesday, Tue |
HH H hh h | hour, 24-hour then 12-hour |
mm ss SSS | minutes, seconds, milliseconds |
A a | AM/PM, am/pm |
ZZ Z zzz | UTC+03:00, +03:00, EEST |
Notes
- Title, background and padding come from the widget’s Appearance settings and are not duplicated here. New instances default to a white card.
- The time is the viewer’s device clock — a badly set system clock shows the wrong time.
- The zone dropdown is a curated list; anything missing goes in via Other.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.