Skip to content
Stand with Ukraine flag

Clock widget

  • Widget
  • 9 installs
  • v1.0.0
  • Aug 18, 2026
  • MIT license
  • v4.2+
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.

Widget Type
  • Static
Category
  • Cards & Info

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 zoneTake 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 formatClock 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 labelShow 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 coloursTime 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 dialDial 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 clockTime 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.

TokensRenders
YYYY YY2026, 26
MMMM MMM MM MAugust, Aug, 08, 8
DD D dddd ddd18, 18, Tuesday, Tue
HH H hh hhour, 24-hour then 12-hour
mm ss SSSminutes, seconds, milliseconds
A aAM/PM, am/pm
ZZ Z zzzUTC+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.