[comment]: # ({7074b2d8-be6356d8})
# 2. Часы
[comment]: # ({/7074b2d8-be6356d8})
[comment]: # ({4044e835-9d7a8838})
### Описание
Эти параметры и возможные значения свойств для соответствующих объектов полей виджета панели позволяют настроить
виджет [*Clock*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) в методах `dashboard.create` и `dashboard.update`.
::: noteimportant
Свойства `fields` виджета не проверяются при создании или обновлении панели.
Это позволяет пользователям изменять [встроенные виджеты](/manual/web_interface/frontend_sections/dashboards/widgets) и создавать [пользовательские виджеты](/devel/modules/tutorials/widget), но также создает риск некорректного создания или обновления виджетов.
Чтобы обеспечить успешное создание или обновление виджета *Clock*, см. поведение параметров, описанное в таблицах ниже.
:::
[comment]: # ({/4044e835-9d7a8838})
[comment]: # ({ec52e598-28857267})
### Параметры
Следующие параметры поддерживаются для виджета *Clock*.
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Интервал обновления*|0|rf_rate|0 - Без обновления;
10 - 10 секунд;
30 - 30 секунд;
60 - 1 минута;
120 - 2 минуты;
600 - 10 минут;
900 - *(по умолчанию)* 15 минут.|
|*Тип времени*|0|time_type|0 - *(по умолчанию)* Местное время;
1 - Время сервера;
2 - Время узла сети.|
|*Тип часов*|0|clock_type|0 - *(по умолчанию)* Аналоговые;
1 - Цифровые.|
Следующие параметры поддерживаются, если для *Тип времени* установлено значение "Время узла сети".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Элемент данных*|4|itemid.0|ID [элемента данных](/manual/api/reference/item/get).
[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *обязательно*|
Следующие параметры поддерживаются, если для *Тип часов* установлено значение "Цифровые".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Показывать*|0|show.0|1 - Дата;
2 - *(по умолчанию)* Время;
3 - Часовой пояс.
Примечание: Чтобы настроить несколько значений, создайте объект поля виджета панели для каждого значения, увеличивая номер в имени свойства.|
[comment]: # ({/ec52e598-28857267})
[comment]: # ({7cfdce97-ab3ddf88})
#### Расширенная конфигурация
Следующие параметры расширенной конфигурации поддерживаются, если для *Clock type* установлено значение "Digital".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Background color*|1|bg_color|Шестнадцатеричный код цвета (например, `FF0000`).
По умолчанию: `""` (пусто).|
[comment]: # ({/7cfdce97-ab3ddf88})
[comment]: # ({557d1498-9f05ef41})
##### Дата
Следующие параметры расширенной настройки поддерживаются, если для *Clock type* установлено значение "Digital", а для *Show* — "Date".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Bold*|0|date_bold|0 - *(по умолчанию)* Отключено;
1 - Включено.|
|*Color*|1|date_color|Шестнадцатеричный код цвета (например, `FF0000`).
По умолчанию: `""` (пусто).|
[comment]: # ({/557d1498-9f05ef41})
[comment]: # ({d2ce0251-76db53db})
##### Время
Следующие параметры расширенной настройки поддерживаются, если для *Clock type* установлено значение "Digital", а для *Show* — значение "Time".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Bold*|0|time_bold|0 - *(по умолчанию)* Отключено;
1 - Включено.|
|*Color*|1|time_color|Шестнадцатеричный код цвета (например, `FF0000`).
По умолчанию: `""` (пусто).|
|*Seconds*|0|time_sec|0 - Отключено;
1 - *(по умолчанию)* Включено.|
|*Format*|0|time_format|0 - *(по умолчанию)* 24-часовой формат;
1 - 12-часовой формат.|
[comment]: # ({/d2ce0251-76db53db})
[comment]: # ({53435cd2-b6649dee})
##### Часовой пояс
Следующие параметры расширенной конфигурации поддерживаются, если для *Clock type* установлено значение "Digital", а для *Show* — "Time zone".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Bold*|0|tzone_bold|0 - *(default)* Disabled;
1 - Enabled.|
|*Color*|1|tzone_color|Шестнадцатеричный код цвета (например, `FF0000`).
По умолчанию: `""` (пусто).|
|*Time zone*|1|tzone_timezone|Допустимая строка часового пояса (например, `Europe/Riga`, `system`, `UTC` и т. д.). Полный список поддерживаемых часовых поясов см. в [документации PHP](https://www.php.net/manual/en/timezones.php).
По умолчанию: `local`.
[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *supported* если для *Time type* установлено значение "Local time" или "Server time"|
|*Format*|0|tzone_format|0 - *(default)* Short;
1 - Full.
[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):
- *supported* если для *Time type* установлено значение "Local time" или "Server time"|
[comment]: # ({/53435cd2-b6649dee})
[comment]: # ({7b4615c3-3b5604a0})
### Примеры
Следующие примеры предназначены только для описания настройки объектов полей виджета панели мониторинга для виджета *Clock*.
Дополнительную информацию о настройке панели мониторинга см. в [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/7b4615c3-3b5604a0})
[comment]: # ({31efb49f-4be326f4})
#### Настройка виджета *Clock*
Настройте виджет *Clock*, который отображает локальные дату, время и часовой пояс в виде настраиваемых цифровых часов.
[Запрос](/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
}
```
Ответ:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/31efb49f-4be326f4})
[comment]: # ({e9d30322-c9d720b7})
### Смотрите также
- [Поле виджета панели](/manual/api/reference/dashboard/object#поле-виджета-панели)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-c9d720b7})