Live local-time clock for your profile

Show collaborators what time it is where you are, and whether you are likely to answer. The clock keeps ticking after the page loads, and it works on GitHub without any scripts.

Digital clock for Tokyo on a card — `asia-tokyo/card`

Analog clock for Berlin with seconds and working-hours status — `europe-berlin/analog/seconds/work-9-17/card`

12-hour clock for New York with date — `america-new_york/12h/date/label-my`

URL builder

Time zone

Style

Hours

First line

Working hours

Size (16 to 96 px)

Theme

Seconds Date Kaomoji Card Hide offset

Image URL

Markdown

![Local time](https://readmes.pages.dev/clock)

Preview

All options

Options are path segments after https://readmes.pages.dev/clock/, in any order. A trailing .svg is allowed. An unknown option renders a small error badge.

Time zone

Option	Effect
`<zone>`	IANA time zone, lowercased, with / written as -. Examples: asia-tokyo, europe-berlin, america-new_york, america-argentina-buenos_aires.
`utc`	Coordinated Universal Time (default).
`utc+9`, `utc-5`, `utc+0530`	A fixed offset from UTC, without daylight saving time.

Clock

Option	Effect
`digital`, `analog`	Clock style (default digital).
`12h`, `24h`	Hour format for the digital clock (default 24h).
`seconds`	Show seconds (a second hand on the analog clock).
`size-N`	Size in pixels, 16 to 96 (default 40); also in rem, e.g. size-2rem (1rem = 16px).
`px`	Pin the image to exact pixels. By default it is sized in rem, so it grows with the reader's browser font size.

Annotation

Option	Effect
`label-city`, `label-local`, `label-my`, `nolabel`	First line: "Tokyo" (default), "Local time in Tokyo", "My time in Tokyo", or nothing.
`nooffset`	Hide the UTC offset, which is shown by default.
`date`	Add the weekday and date.
`work-H-H`	Working hours, e.g. work-9-18. Adds a live status line: working hours, off hours, weekend or probably asleep.
`sleep-H-H`	Sleeping hours for the status line (default sleep-23-7).
`days-mon-fri`, `everyday`	Which days are working days (default Monday to Friday).
`kaomoji`	Add a small face to the status line. Without work hours it shows morning, daytime, evening or night.

Look

Option	Effect
`card`	Rounded card background.
`border-N`	Card border in pixels, 0 to 8; implies card.
`color-RRGGBB`	Accent and time color as 3 or 6 hex digits without #.
`auto`, `light`, `dark`, `transparent`	Theme (default auto).

How it keeps time

The server draws the current time in your zone, including daylight saving time. Inside the image, each digit is a column of all its possible values, and CSS slides each column at the right speed. The clock therefore keeps running for as long as the page stays open. The image is never cached, so every page load starts from the exact time.