---
title: "Homarr Clock Widget — Date & Time Display"
aliases: [homarr-date-time, homarr-clock]
tags: [homarr, homelab, widget, dashboard]
sources: [raw/Date and time  Homarr documentation.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

The **Clock widget** displays the current date and time on a Homarr board. It supports custom timezones, 12/24-hour formats, seconds display, and fully custom time/date format strings.

## Configuration Options

| Name | Description | Default |
|------|-------------|---------|
| Custom Title/City display | Show a custom label above the clock | no |
| Title | Text shown above the clock (requires custom title enabled) | — |
| 24-hour format | Toggle 12h vs 24h display | yes (24h) |
| Display seconds | Show seconds in the time | no |
| Use fixed timezone | Override client timezone with a server-side IANA zone | no |
| Timezone | IANA timezone string (e.g. `Europe/Berlin`, `America/New_York`) | Europe/London |
| Show the date | Show date below the clock | yes |
| Date format | Preset date format (e.g. `DD/MM/YYYY`, `MM/DD/YYYY`) | dddd, MMMM D |
| Custom time format | ISO 8601 time string (e.g. `HH:mm:ss`, `hh:mm A`) | — |
| Custom date format | ISO 8601 date string (e.g. `YYYY-MM-DD`) | — |

## Key Takeaways

- Default timezone is `Europe/London` — change to your local IANA zone for accuracy
- Custom time/date format fields use **ISO 8601 / Moment.js tokens** (`HH`, `mm`, `ss`, `A`, `YYYY`, `DD`, etc.)
- The fixed timezone option is useful for **world clock panels** showing multiple cities simultaneously — add one widget per timezone
- Seconds are hidden by default; enable them only if you need live precision (increases render updates)
- Custom title can display a **city name** above the clock — ideal when using fixed timezone per widget

## Adding the Widget

Follow the standard widget add flow documented in [[wiki/homelab/homarr-boards|Homarr Boards]].

## Related

- [[wiki/homelab/homarr-boards|Homarr Boards — Dashboard Management]]
- [[wiki/homelab/homarr-settings|Homarr Settings — Global Application Configuration]]
- [[wiki/homelab/homarr-apps|Homarr Apps — Managing Dashboard Links & Status Checks]]

## Sources

- `raw/Date and time  Homarr documentation.md` — Homarr docs v1.59.2
