---
name: "yambar-modules-clock"
section: "5"
platform: "linux"
package: "yambar"
version: "1.11.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yambar-modules-clock"
---

# yambar-modules-clock(5)

This module provides the current date and time

## NAME

clock - This module provides the current date and time

## TAGS

| | | |
| --- | --- | --- |
| **Name** | **Type** | **Description** |
| time | string | Current time, formatted using the *time-format* attribute |
| date | string | Current date, formatted using the *date-format* attribute |

## CONFIGURATION

| | | | |
| --- | --- | --- | --- |
| **Name** | **Type** | **Req** | **Description** |
| time-format | string | no | **strftime** formatter for the *time* tag (default=**%H:%M**) |
| date-format | string | no | **strftime** formatter for the *date* date (default=**%x**) |
| utc | bool | no | Use GMT instead of local timezone (default=false) |

## EXAMPLES

```
bar:
  left:
    - clock:
        time-format: "%H:%M %Z"
        content:
          string: {text: "{date} {time}"}
```

## SEE ALSO

[**yambar-modules**(5)](/yambar-modules/5.md), [**yambar-particles**(5)](/yambar-particles/5.md), [**yambar-tags**(5)](/yambar-tags/5.md), [**yambar-decorations**(5)](/yambar-decorations/5.md)