Polja obrazca: Date and Time

Datum in ura v enem polju: gradnik prispeva brskalnik, časovni pas pa namenoma ostaja zunaj pogodbe polja.

1. Pregled in namen

Stanje: [Live]. Referenca: DevExpress-ov ASPxDateEdit v časovnem načinu.

2. Predpogoji

3. Pojmi

Časovni pas – namerno zunaj pogodbe polja: <input type="datetime-local"> ne nosi nobenega podatka o časovnem pasu – brskalnik priskrbi naiven časovni žig brez odmika. To polje ne odloči, v katerem časovnem pasu naj se vrednost razlaga; to je stvar klicatelja/strežnika (dosledno po celotni aplikaciji, ne različno po obrazcu). Izvedba dokumentira izbrano konvencijo na mestu, kjer dejansko velja, ne tukaj kot ugibanje.

4. Prvi koraki

echo $widgets->dateTime([
    'name'  => 'nacrtovano_od',
    'label' => 'Načrtovano od',
    'kind'  => 'datetime',
]);

5. Uporaba

`$opts['kind']`	Nativni kontrolnik	Oblika zapisa `value`
`date`	`<input type="date">`	`YYYY-MM-DD` – enako kot pri Calendar
`time`	`<input type="time">`	`HH:MM`
`datetime` (privzeto)	`<input type="datetime-local">`	`YYYY-MM-DDTHH:MM`

6. API referenca

Metoda dateTime(array $opts): string v helper_plugin_wkfluentui_widgets.

7. Parametri, možnosti in stanja

Ključ	Tip	Pomen
`kind`	`'date'\|'time'\|'datetime'`	glej odsek 5, privzeto `datetime`
`min`/`max`	string (ustrezno `kind`)	nativna atributa `min`/`max`
`step`	int (sekunde)	nativni atribut `step`, npr. `60` za natančnost na minuto brez polja sekund

8. Popolni primeri

echo $widgets->dateTime([
    'name'  => 'cas_izteka',
    'label' => 'Čas izteka',
    'kind'  => 'time',
    'step'  => 60,
]);

9. Omejitve in robni primeri

Nobenih onkraj strani funkcij.

10. Dostopnost in združljivost

Celoten pregled: Accessibility.

11. Odpravljanje težav

Se ne uporablja.

12. Sorodne teme

predstavitveni pregled – vsaka kategorija
Polja obrazca: Calendar – gol datum brez časovnega dela
Polja obrazca: osnove – skupna pogodba polj