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

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

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

Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord correspondants permettent de configurer le widget [*Clock*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) dans les méthodes `dashboard.create` et `dashboard.update`.

::: noteimportant
Les propriétés `fields` du widget ne sont pas validées lors de la création ou de la mise à jour d’un tableau de bord.
Cela permet aux utilisateurs de modifier les [widgets intégrés](/manual/web_interface/frontend_sections/dashboards/widgets) et de créer des [widgets personnalisés](/devel/modules/tutorials/widget), mais introduit également le risque de créer ou de mettre à jour des widgets de manière incorrecte.
Pour garantir la réussite de la création ou de la mise à jour du widget *Clock*, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
:::

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

[comment]: # ({ec52e598-28857267})
### Paramètres

Les paramètres suivants sont pris en charge pour le widget *Horloge*.

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Intervalle d’actualisation*|0|rf_rate|0 - Pas d’actualisation ;<br>10 - 10 secondes ;<br>30 - 30 secondes ;<br>60 - 1 minute ;<br>120 - 2 minutes ;<br>600 - 10 minutes ;<br>900 - *(par défaut)* 15 minutes.|
|*Type d’heure*|0|time_type|0 - *(par défaut)* Heure locale ;<br>1 - Heure du serveur ;<br>2 - Heure de l’hôte.|
|*Type d’horloge*|0|clock_type|0 - *(par défaut)* Analogique ;<br>1 - Numérique.|

Les paramètres suivants sont pris en charge si *Type d’heure* est défini sur "Heure de l’hôte".

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Élément*|4|itemid.0|ID de l’[élément](/manual/api/reference/item/get).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire*|

Les paramètres suivants sont pris en charge si *Type d’horloge* est défini sur "Numérique".

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Afficher*|0|show.0|1 - Date ;<br>2 - *(par défaut)* Heure ;<br>3 - Fuseau horaire.<br><br>Remarque : pour configurer plusieurs valeurs, créez un objet de champ de widget de tableau de bord pour chaque valeur avec un numéro incrémenté dans le nom de la propriété.|

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

[comment]: # ({7cfdce97-ab3ddf88})
#### Configuration avancée

Les paramètres de configuration avancée suivants sont pris en charge si le *Type d'horloge* est défini sur « Numérique ».

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Couleur d’arrière-plan*|1|bg_color|Code couleur hexadécimal (par ex. `FF0000`).<br><br>Par défaut : `""` (vide).|

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

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

Les paramètres de configuration avancés suivants sont pris en charge si *Clock type* est défini sur « Digital » et *Show* sur « Date ».

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Gras*|0|date_bold|0 - *(par défaut)* Désactivé ;<br>1 - Activé.|
|*Couleur*|1|date_color|Code couleur hexadécimal (par exemple, `FF0000`).<br><br>Par défaut : `""` (vide).|

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

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

Les paramètres de configuration avancés suivants sont pris en charge si *Type d’horloge* est défini sur « Digital » et *Afficher* sur « Heure ».

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Gras*|0|time_bold|0 - *(par défaut)* Désactivé;<br>1 - Activé.|
|*Couleur*|1|time_color|Code couleur hexadécimal (par ex. `FF0000`).<br><br>Par défaut : `""` (vide).|
|*Secondes*|0|time_sec|0 - Désactivé;<br>1 - *(par défaut)* Activé.|
|*Format*|0|time_format|0 - *(par défaut)* 24 heures;<br>1 - 12 heures.|

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

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

Les paramètres de configuration avancée suivants sont pris en charge si *Type d’horloge* est défini sur « Digital » et *Afficher* est défini sur « Fuseau horaire ».

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Gras*|0|tzone_bold|0 - *(par défaut)* Désactivé;<br>1 - Activé.|
|*Couleur*|1|tzone_color|Code couleur hexadécimal (par ex. `FF0000`).<br><br>Par défaut : `""` (vide).|
|*Fuseau horaire*|1|tzone_timezone|Chaîne de fuseau horaire valide (par ex. `Europe/Riga`, `system`, `UTC`, etc.). Pour la liste complète des fuseaux horaires pris en charge, veuillez consulter la [documentation PHP](https://www.php.net/manual/en/timezones.php).<br><br>Par défaut : `local`.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si *Type d’heure* est défini sur « Heure locale » ou « Heure du serveur »|
|*Format*|0|tzone_format|0 - *(par défaut)* Court;<br>1 - Complet.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si *Type d’heure* est défini sur « Heure locale » ou « Heure du serveur »|

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

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

Les exemples suivants visent à décrire uniquement la configuration des objets de champ du widget de tableau de bord pour le widget *Horloge*.
Pour plus d'informations sur la configuration d'un tableau de bord, consultez [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({31efb49f-4be326f4})
#### Configuration d’un widget *Clock*

Configurez un widget *Clock* qui affiche la date locale, l’heure et le fuseau horaire dans une horloge numérique personnalisée. 

[Requête](/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
}
```

Réponse :

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

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

[comment]: # ({e9d30322-c9d720b7})
### Voir également

- [Champ du widget du tableau de bord](/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})