[comment]: # translation:outdated
[comment]: # ({7074b2d8-be6356d8})
# 2 Clock
[comment]: # ({/7074b2d8-be6356d8})
[comment]: # ({4044e835-9d7a8838})
### 説明
これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*時計*](/manual/web_interface/frontend_sections/dashboards/widgets/clock)ウィジェットを設定できます。
::: noteimportant
ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。
これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/dashboards/widgets)を変更したり、[カスタムウィジェット](/devel/modules/tutorials/widget)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。
*時計*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーターの動作を参照してください。
:::
[comment]: # ({/4044e835-9d7a8838})
[comment]: # ({ec52e598-28857267})
### パラメーター
*時計*ウィジェットでは、以下のパラメーターがサポートされています。
|パラメーター|[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 - デジタル|
*時間の形式*が"ホスト時間"に設定されている場合、以下のパラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*アイテム*|4|itemid.0|[アイテム](/manual/api/reference/item/get)ID。
[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *必須*|
*時計のタイプ*が"デジタル"に設定されている場合、以下のパラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*表示*|0|show.0|1 - 日付
2 - *(デフォルト)* 時刻
3 - タイムゾーン
注意: 複数の値を構成するには、プロパティ名に増分番号を付けた各値のダッシュボードウィジェットフィールドオブジェクトを作成します。|
[comment]: # ({/ec52e598-28857267})
[comment]: # ({7cfdce97-ab3ddf88})
#### 詳細設定
*時計のタイプ*が"デジタル"に設定されている場合、以下の詳細設定パラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*背景色*|1|bg_color|16進数の色コード(例: `FF0000`)。
デフォルト: `""` (空)。|
[comment]: # ({/7cfdce97-ab3ddf88})
[comment]: # ({557d1498-9f05ef41})
##### 日付
*時計のタイプ*が"デジタル"に設定され、*表示*が"日付"に設定されている場合、以下の詳細設定パラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*太字*|0|date_bold|0 - *(デフォルト)* 無効
1 - 有効|
|*色*|1|date_color|16進数のカラーコード(例: `FF0000`)。
デフォルト: `""` (空)。|
[comment]: # ({/557d1498-9f05ef41})
[comment]: # ({d2ce0251-76db53db})
##### 時間
*時計のタイプ*が"デジタル"に設定され、*表示*が"時刻"に設定されている場合、以下の詳細設定パラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*太字*|0|time_bold|0 - *(デフォルト)* 無効
1 - 有効|
|*色*|1|time_color|16進数のカラーコード(例: `FF0000`)。
デフォルト: `""` (空)。|
|*秒*|0|time_sec|0 - 無効
1 - *(デフォルト)* 有効|
|*形式*|0|time_format|0 - *(デフォルト)* 24時間
1 - 12時間|
[comment]: # ({/d2ce0251-76db53db})
[comment]: # ({53435cd2-b6649dee})
##### タイムゾーン
*時計のタイプ*が"デジタル"に設定され、*表示*が"タイムゾーン"に設定されている場合、以下の詳細設定パラメーターがサポートされます。
|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*太字*|0|tzone_bold|0 - *(デフォルト)* 無効
1 - 有効|
|*色*|1|tzone_color|16進数のカラーコード(例: `FF0000`)。
デフォルト: `""` (空)。|
|*タイムゾーン*|1|tzone_timezone|有効なタイムゾーン文字列(例: `Europe/Riga`、`system`、`UTC`など)。サポートされているタイムゾーンの完全なリストについては、[PHPドキュメント](https://www.php.net/manual/en/timezones.php)を参照してください。
デフォルト: `local`。
[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *時間の形式*が"ローカル時間"または"サーバー時間"に設定されている場合は*サポート*|
|*フォーマット*|0|tzone_format|0 - *(デフォルト)* 短縮形式
1 - 完全形式
[パラメーターの動作](/manual/api/reference_commentary#parameter-behavior):
- *時間の形式*が"ローカル時間"または"サーバー時間"に設定されている場合は*サポート*|
[comment]: # ({/53435cd2-b6649dee})
[comment]: # ({7b4615c3-3b5604a0})
### 例
次の例は、*時計*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。
ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。
[comment]: # ({/7b4615c3-3b5604a0})
[comment]: # ({31efb49f-4be326f4})
#### *時計*ウィジェットの設定
カスタマイズされたデジタル時計にローカルの日付、時間、およびタイムゾーンを表示する*時計*ウィジェットを設定します。
[リクエスト](/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})
### 参照
- [Dashboard widget field](/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})