[comment]: # ({7074b2d8-be6356d8})
# 2 Uhr

[comment]: # ({/7074b2d8-be6356d8})

[comment]: # ({4044e835-9d7a8838})
### Beschreibung

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Feldobjekte des Dashboard-Widgets ermöglichen die Konfiguration des Widgets [*Clock*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) in den Methoden `dashboard.create` und `dashboard.update`.

::: noteimportant
Die Eigenschaften von Widget-`fields` werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dies ermöglicht Benutzern, [integrierte Widgets](/manual/web_interface/frontend_sections/dashboards/widgets) zu ändern und [benutzerdefinierte Widgets](/devel/modules/tutorials/widget) zu erstellen, birgt jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets *Clock* sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
:::

[comment]: # ({/4044e835-9d7a8838})

[comment]: # ({ec52e598-28857267})
### Parameter

Die folgenden Parameter werden für das *Uhr*-Widget unterstützt.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Aktualisierungsintervall*|0|rf_rate|0 - Keine Aktualisierung;<br>10 - 10 Sekunden;<br>30 - 30 Sekunden;<br>60 - 1 Minute;<br>120 - 2 Minuten;<br>600 - 10 Minuten;<br>900 - *(Standard)* 15 Minuten.|
|*Zeittyp*|0|time_type|0 - *(Standard)* Lokale Zeit;<br>1 - Serverzeit;<br>2 - Host-Zeit.|
|*Uhrtyp*|0|clock_type|0 - *(Standard)* Analog;<br>1 - Digital.|

Die folgenden Parameter werden unterstützt, wenn *Zeittyp* auf „Host-Zeit“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Datenpunkt*|4|itemid.0|ID des [Datenpunkts](/manual/api/reference/item/get).<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|

Die folgenden Parameter werden unterstützt, wenn *Uhrtyp* auf „Digital“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Anzeigen*|0|show.0|1 - Datum;<br>2 - *(Standard)* Uhrzeit;<br>3 - Zeitzone.<br><br>Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.|

[comment]: # ({/ec52e598-28857267})

[comment]: # ({7cfdce97-ab3ddf88})
#### Erweiterte Konfiguration

Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn *Clock type* auf „Digital“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Hintergrundfarbe*|1|bg_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: `""` (leer).|

[comment]: # ({/7cfdce97-ab3ddf88})

[comment]: # ({557d1498-9f05ef41})
##### Datum

Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn *Clock type* auf „Digital“ und *Show* auf „Date“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Fett*|0|date_bold|0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert.|
|*Farbe*|1|date_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: `""` (leer).|

[comment]: # ({/557d1498-9f05ef41})

[comment]: # ({d2ce0251-76db53db})
##### Zeit

Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn *Clock type* auf „Digital“ und *Show* auf „Time“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Fett*|0|time_bold|0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert.|
|*Farbe*|1|time_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: `""` (leer).|
|*Sekunden*|0|time_sec|0 - Deaktiviert;<br>1 - *(Standard)* Aktiviert.|
|*Format*|0|time_format|0 - *(Standard)* 24-Stunden-Format;<br>1 - 12-Stunden-Format.|

[comment]: # ({/d2ce0251-76db53db})

[comment]: # ({53435cd2-b6649dee})
##### Zeitzone

Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn *Clock type* auf „Digital“ und *Show* auf „Zeitzone“ gesetzt ist.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Fett*|0|tzone_bold|0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert.|
|*Farbe*|1|tzone_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: `""` (leer).|
|*Zeitzone*|1|tzone_timezone|Gültige Zeitzonen-Zeichenfolge (z. B. `Europe/Riga`, `system`, `UTC` usw.). Eine vollständige Liste der unterstützten Zeitzonen finden Sie in der [PHP-Dokumentation](https://www.php.net/manual/en/timezones.php).<br><br>Standard: `local`.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Time type* auf „Local time“ oder „Server time“ gesetzt ist|
|*Format*|0|tzone_format|0 - *(Standard)* Kurz;<br>1 - Vollständig.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Time type* auf „Local time“ oder „Server time“ gesetzt ist|

[comment]: # ({/53435cd2-b6649dee})

[comment]: # ({7b4615c3-3b5604a0})
### Beispiele

Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das *Clock*-Widget. Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/7b4615c3-3b5604a0})

[comment]: # ({31efb49f-4be326f4})
#### Konfigurieren eines *Uhr*-Widgets

Konfigurieren Sie ein *Uhr*-Widget, das lokales Datum, Uhrzeit und Zeitzone in einer angepassten digitalen Uhr anzeigt. 

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "clock",
                        "name": "Clock",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "clock_type",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show.0",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show.1",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show.2",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "date_color",
                                "value": "E1E1E1"
                            },
                            {
                                "type": 0,
                                "name": "time_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "tzone_color",
                                "value": "E1E1E1"
                            },
                            {
                                "type": 1,
                                "name": "tzone_timezone",
                                "value": "Europe/Riga"
                            },
                            {
                                "type": 0,
                                "name": "tzone_format",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/31efb49f-4be326f4})

[comment]: # ({e9d30322-c9d720b7})
### Siehe auch

-   [Dashboard Widget Feld](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-c9d720b7})