[comment]: # ({7074b2d8-be6356d8})
# 2 Reloj
[comment]: # ({/7074b2d8-be6356d8})
[comment]: # ({4044e835-9d7a8838})
### Descripción
Estos parámetros y los posibles valores de la propiedad para los respectivos objetos de campo del widget del tablero permiten configurar
el widget [*Reloj*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) en los métodos `dashboard.create` y `dashboard.update`.
::: noteimportant
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero.
Esto permite a los usuarios modificar los [widgets integrados](/manual/web_interface/frontend_sections/dashboards/widgets) y crear [widgets personalizados](/devel/modules/tutorials/widget), pero también introduce el riesgo de crear o actualizar widgets. incorrectamente.
Para garantizar la creación o actualización exitosa del widget *Reloj*, consulte el comportamiento de los parámetros descrito en las tablas siguientes.
:::
[comment]: # ({/4044e835-9d7a8838})
[comment]: # ({8229c207-28857267})
### Parámetros
Los siguientes parámetros son compatibles con el widget *Reloj*.
|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Intervalo de actualización*|0|rf_rate|0 - Sin actualización;
10 - 10 segundos;
30 - 30 segundos;
60 - 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - *(predeterminado)* 15 minutos.|
|*Tipo de hora*|0|time_type|0 - *(predeterminado)* Hora local;
1 - Hora del servidor;
2 - Hora del host.|
|*Tipo de reloj*|0|clock_type|0 - *(predeterminado)* Analógico;
1 - Digital.|
Los siguientes parámetros son compatibles si *Tipo de hora* está configurado en "Hora del equipo".
|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Métrica*|4|itemid|[Métrica](/manual/api/reference/item/get) ID.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatorio*|
Los siguientes parámetros son compatibles si *Tipo de reloj* está configurado en "Digital".
|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Mostrar*|<|0|show|1 - Fecha;
2 - *(predeterminado)* Hora;
3 - Zona horaria.
Nota: Para configurar varios valores, cree un objeto de campo del widget del panel para cada valor.|
|*Configuración avanzada*|<|0|adv_conf|0 - *(predeterminado)* Deshabilitado;
1 - Habilitado.
El parámetro *Configuración avanzada* debe establecerse en "Habilitado" para configurar *Fondo color* y todas las opciones para *Fecha*, *Hora* y *Zona horaria*.|
|*Color de fondo*|<|1|bg_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Predeterminado: `""` (vacío).|
|*Fecha*|<|<|<|<|
|<|*Tamaño*|0|date_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 20.|
|^|*Negrita*|0|date_bold|0 - *(predeterminado)* Deshabilitado;
1 - Habilitado.|
|^|*Color*|1|date_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Predeterminado: `""` (vacío).|
|*Hora*|<|<|<|<|
|<|*Tamaño*|0|time_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 30.|
|^|*Negrita*|0|time_bold|0 - *(predeterminado)* Deshabilitado;
1 - Habilitado.|
|^|*Color*|1|time_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Predeterminado: `""` (vacío).|
|^|*Segundos*|0|time_sec|0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
|^|*Formato*|0|time_format|0 - *(predeterminado)* 24 horas;
1 - 12 horas.|
|*Zona horaria*|<|<|<|<|
|<|*Tamaño*|0|tzone_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 20.|
|^|*Negrita*|0|tzone_bold|0 - *(predeterminado)* Deshabilitado;
1 - Habilitado.|
|^|*Color*|1|tzone_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Predeterminado: `""` (vacío).|
|^|*Zona horaria*|1|tzone_timezone|Cadena de zona horaria válida (por ejemplo, `Europa/Riga`, `system`, `UTC`, etc.). Para obtener la lista completa de zonas horarias admitidas, consulte la [documentación de PHP](https://www.php.net/manual/en/timezones.php).
Predeterminado: `local`.
El parámetro *Zona horaria* no está disponible si *Tipo de hora* está configurado en "Hora del host".|
|^|*Formato*|0|tzone_format|0 - *(predeterminado)* Corto;
1 - Completo.
El parámetro *Formato* no está disponible si *Tipo de hora* está configurado en "Hora del host ".|
[comment]: # ({/8229c207-28857267})
[comment]: # ({7b4615c3-3b5604a0})
### Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget *Reloj*.
Para obtener más información sobre cómo configurar un tablero, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/7b4615c3-3b5604a0})
[comment]: # ({52884ef3-4be326f4})
#### Configuración de un widget *Reloj*
Configure un widget *Reloj* que muestre la fecha, hora y zona horaria local en un reloj digital personalizado.
[Solicitud](/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": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "clock_type",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 0,
"name": "date_size",
"value": 20
},
{
"type": 1,
"name": "date_color",
"value": "E1E1E1"
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 0,
"name": "tzone_size",
"value": 10
},
{
"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
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/52884ef3-4be326f4})
[comment]: # ({e9d30322-c9d720b7})
### Ver también
- [Campo de widget de tablero](/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})