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

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

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

Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Pulksteņa*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) logrīku `dashboard.create` un `dashboard.update` metodēs.

::: noteimportant
Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā.
Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi.
Lai nodrošinātu veiksmīgu *Pulksteņa* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību.
:::

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

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

Tālāk norādītie parametri tiek atbalstīti *Pulksteņa* logrīkam.

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Atsvaidzināšanas intervāls*|0|rf_rate|0 - Bez atsvaidzināšanas;<br>10 - 10 sekundes;<br>30 - 30 sekundes;<br>60 - 1 minūte;<br>120 - 2 minūtes;<br>600 - 10 minūtes;<br>900 - *(noklusējums)* 15 minūtes.|
|*Laika tips*|0|time_type|0 - *(noklusējums)* Vietējais laiks;<br>1 - Servera laiks;<br>2 - Hosta laiks.|
|*Pulksteņa tips*|0|clock_type|0 - *(noklusējums)* Analogais;<br>1 - Digitālais.|

Tālāk norādītie parametri tiek atbalstīti, ja *Laika tips* ir iestatīts uz "Hosta laiks".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Vienums*|4|itemid.0|[Vienuma](/manual/api/reference/item/get) ID.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*|

Tālāk norādītie parametri tiek atbalstīti, ja *Pulksteņa tips* ir iestatīts uz "Digitālais".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Rādīt*|0|show.0|1 - Datums;<br>2 - *(noklusējums)* Laiks;<br>3 - Laika josla.<br><br>Piezīme: Lai konfigurētu vairākas vērtības, izveidojiet informācijas paneļa logrīka lauka objektu katrai vērtībai ar palielinātu numuru rekvizīta nosaukumā.|

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

[comment]: # ({7cfdce97-ab3ddf88})
#### Papildu konfigurācija

Tālāk norādītie papildu konfigurācijas parametri tiek atbalstīti, ja *Pulksteņa tips* ir iestatīts uz "Digitāls".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Fona krāsa*|1|bg_color|Heksadecimālais krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).|

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

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

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Clock type* ir iestatīts uz "Digital" un *Show* ir iestatīts uz "Date".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Treknraksts*|0|date_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.|
|*Krāsa*|1|date_color|Heksadecimālais krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).|

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

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

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Pulksteņa tips* ir iestatīts uz "Digitāls" un *Rādīt* ir iestatīts uz "Laiks".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Treknraksts*|0|time_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.|
|*Krāsa*|1|time_color|Heksadecimālais krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).|
|*Sekundes*|0|time_sec|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.|
|*Formāts*|0|time_format|0 - *(noklusējums)* 24 stundu;<br>1 - 12 stundu.|

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

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

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Pulksteņa tips* ir iestatīts uz "Digital" un *Rādīt* ir iestatīts uz "Laika josla".

|Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Treknraksts*|0|tzone_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.|
|*Krāsa*|1|tzone_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).|
|*Laika josla*|1|tzone_timezone|Derīga laika joslas virkne (piemēram, `Europe/Riga`, `system`, `UTC` utt.). Pilnu atbalstīto laika joslu sarakstu skatiet [PHP dokumentācijā](https://www.php.net/manual/en/timezones.php).<br><br>Noklusējums: `local`.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika tips* ir iestatīts uz "Local time" vai "Server time"|
|*Formāts*|0|tzone_format|0 - *(noklusējums)* Īss;<br>1 - Pilns.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika tips* ir iestatīts uz "Local time" vai "Server time"|

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

[comment]: # ({7b4615c3-3b5604a0})
### Piemēri

Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Pulksteņa* logrīkam.
Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({31efb49f-4be326f4})
#### *Clock* logrīka konfigurēšana

Konfigurējiet *Clock* logrīku, kas pielāgotā digitālajā pulkstenī attēlo vietējo datumu, laiku un laika joslu. 

[Pieprasījums](/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
}
```

Atbilde:

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

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

[comment]: # ({e9d30322-c9d720b7})
### Skatiet arī

-   [Informācijas paneļa logrīka lauks](/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})