# World clock card

> Canonical HTML: https://screenrig.ai/docs/cards/world-clock/

The time in several cities at once, with day and night, tomorrow and yesterday, and each city's offset from here.

Category: Time. Tags: Clocks and calendars, Offices and workplaces, Lobbies and reception.

## Previews

![World clock](/cards/world-clock/v1/screenshots/canvas-bloom.webp?sha=0380deb8bfbae94df38ca1412ffab75ce65f91fc85d32f7ef61ba274a950486b)

Canvas

![World clock](/cards/world-clock/v1/screenshots/corner-bloom.webp?sha=eb8b1285e50a18e2c4a53dd7a268c71ff1c4bef0881d0d94cc33a60f512d1a15)

Corner

![World clock](/cards/world-clock/v1/screenshots/chip-bloom.webp?sha=feae7f21e31f7a7f93824784034581f176ef9c854d7082813e9ef4d7fb2b189f)

Chip

## Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait, strip.

[Card views, themes and publishing](/docs/cards/). [Browse the gallery](/apps/#cards).

## Data and privacy

This card uses its configured properties and live card data.

## Properties

For theme, background, accent and position, see [Common properties](/docs/cards/#common-properties).

Set static properties in `params`. Bind `data` to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in `params`. Nested rows describe the contents of their parent property.

### Static properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `cities` | array |  | minItems: `2`; maxItems: `12`; Required |  |
| `cities[].label` | string |  | minLength: `1`; maxLength: `40`; Required |  |
| `cities[].timeZone` | string |  | minLength: `1`; maxLength: `64`; Required | IANA zone. |
| `hour12` | boolean | `false` |  |  |
| `showSeconds` | boolean | `false` |  |  |
| `showDate` | boolean | `true` |  | Show Tomorrow, Yesterday or the weekday under each city. |
| `face` | string | `"digital"` | `"digital"`, `"analog"` |  |
| `highlight` | integer | `-1` | minimum: `-1`; maximum: `11` | Index of a home city to emphasise; -1 for none. |

### Dynamic properties

This card has no dynamic properties.

## Canvas example

Add this item to a playlist page’s `primitives`. [Publish the playlist and assign a screen](/docs/cards/#publish-a-card-canvas).

```json
{
  "id": "world-clock",
  "primitive": "card",
  "card": "world-clock",
  "major": 1,
  "params": {
    "theme": "neomustard",
    "cities": [
      {
        "label": "Example",
        "timeZone": "Example"
      },
      {
        "label": "Example",
        "timeZone": "Example"
      }
    ]
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill"
}
```