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

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

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

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget [*Orologio*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) nei metodi `dashboard.create` e `dashboard.update`.

::: noteimportant
Le proprietà `fields` del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard.
Questo consente agli utenti di modificare i [widget built-in](/manual/web_interface/frontend_sections/dashboards/widgets) e creare [widget personalizzati](/devel/modules/tutorials/widget), ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget *Orologio*, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
:::

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

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

I seguenti parametri sono supportati per il widget *Clock*.

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Intervallo di aggiornamento*|0|rf_rate|0 - Nessun aggiornamento;<br>10 - 10 secondi;<br>30 - 30 secondi;<br>60 - 1 minuto;<br>120 - 2 minuti;<br>600 - 10 minuti;<br>900 - *(predefinito)* 15 minuti.|
|*Tipo di ora*|0|time_type|0 - *(predefinito)* Ora locale;<br>1 - Ora del server;<br>2 - Ora del host.|
|*Tipo di orologio*|0|clock_type|0 - *(predefinito)* Analogico;<br>1 - Digitale.|

I seguenti parametri sono supportati se *Tipo di ora* è impostato su "Ora del host".

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Item*|4|itemid.0|ID [item](/manual/api/reference/item/get).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|

I seguenti parametri sono supportati se *Tipo di orologio* è impostato su "Digitale".

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Mostra*|0|show.0|1 - Data;<br>2 - *(predefinito)* Ora;<br>3 - Fuso orario.<br><br>Nota: per configurare più valori, creare un oggetto campo widget della dashboard per ciascun valore con un numero incrementato nel nome della proprietà.|

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

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

I seguenti parametri di configurazione avanzata sono supportati se *Clock type* è impostato su "Digital".

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Colore di sfondo*|1|bg_color|Codice colore esadecimale (ad es. `FF0000`).<br><br>Predefinito: `""` (vuoto).|

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

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

I seguenti parametri di configurazione avanzata sono supportati se *Clock type* è impostato su "Digital" e *Show* è impostato su "Date".

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Grassetto*|0|date_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|date_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|

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

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

I seguenti parametri di configurazione avanzata sono supportati se *Clock type* è impostato su "Digital" e *Show* è impostato su "Time".

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Grassetto*|0|time_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|time_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|*Secondi*|0|time_sec|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.|
|*Formato*|0|time_format|0 - *(predefinito)* 24 ore;<br>1 - 12 ore.|

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

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

I seguenti parametri di configurazione avanzata sono supportati se *Clock type* è impostato su "Digital" e *Show* è impostato su "Time zone".

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Grassetto*|0|tzone_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|tzone_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|*Fuso orario*|1|tzone_timezone|Stringa di fuso orario valida (ad esempio `Europe/Riga`, `system`, `UTC`, ecc.). Per l'elenco completo dei fusi orari supportati, fare riferimento alla [documentazione PHP](https://www.php.net/manual/en/timezones.php).<br><br>Predefinito: `local`.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Time type* è impostato su "Local time" o "Server time"|
|*Formato*|0|tzone_format|0 - *(predefinito)* Breve;<br>1 - Completo.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Time type* è impostato su "Local time" o "Server time"|

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

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

Gli esempi seguenti mirano a descrivere solo la configurazione degli oggetti campo del widget del dashboard per il widget *Orologio*.
Per ulteriori informazioni sulla configurazione di un dashboard, vedere [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({31efb49f-4be326f4})
#### Configurazione di un widget *Clock*

Configurare un widget *Clock* che visualizza data, ora e fuso orario locali in un orologio digitale personalizzato. 

[Richiesta](/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
}
```

Risposta:

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

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

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

- [Campo del widget della dashboard](/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})