Maske datuma/časa
Maska datum/čas lahko služi enemu od dveh namenov: določa format izhodnih podatkov različnih funkcij ali vodi pretvorbo iz nizovne predstavitve vrednosti v notranjo obliko te vrednosti.
V nadaljevanju sta prikazana dva načina, na katera je mogoče uporabiti masko datum/čas:
- Določa obliko izhodnih podatkov raznih funkcij. V funkciji timetostring maska datuma/časa na primer nakazuje obliko, ki naj bo uporabljena za nizovne izhodne podatke. Če je maska datuma/časa "hh:tt:ss" in je časovna vrednost enaka 24 sekundam čez 9:12, je izhodni niz 09:12:24.
- Vodi pretvorbo iz nizovne predstavitve vrednosti v notranjo obliko te vrednosti. V funkciji stringtotime maska datuma/časa na primer nakazuje obliko vhodnega niza zato, da bo pravilno spremenjen v časovno vrednost. Če je vhodni niz "05/06/1995", maska datuma/časa "mm/dd/yyyy" nakazuje, da podniz "05" predstavlja mesec in ne dan.
Maska datuma/časa je nizovni izraz, ki vsebuje katerokoli veljavno kombinacijo komponent in, če želite, ločil. Ker je maska datuma/časa niz, jo morate pisati v dvojne narekovaje.
Za primere uporabe glejte informacije o vzorcih mask datuma/časa.
Komponente
V maski datuma/časa so dovoljene naslednje komponente. Veljaven obseg je naveden za tiste komponente, na katere se nanaša.
Komponenta | Pomen |
---|---|
dd | Dan v mesecu, zapisan z dvema števkama (1–31). |
ddd | Dan v letu, zapisan s tremi števkami (1–366). |
mm | Mesec, zapisan z eno ali dvema števkama (1–12). |
mon | Trimestna kratica meseca (jan–dec). |
month | Popolno ime meseca (januar–december). |
yy | Leto, zapisano z dvema števkama (00–99). Močno priporočamo uporabo komponente s štirimi števkami (yyyy) in ne komponente z dvema števkama. Pri komponenti z dvema števkama je notranje predvideno, da sta prvi dve števki "20", kar morda ni vaš namen. Poleg tega pa komponenta s štirimi števkami jasno določa stoletje in izloči vse mogoče težave z dvoumnostjo. |
yyyy | Leto, zapisano s štirimi števkami (0000–9999). |
w | Števka za dan v tednu (0–6, 0 = nedelja, 6 = sobota). |
day | Trimestna kratica dneva (sob–ned). |
dayname | Popolno ime dneva (nedelja–sobota). |
hh | Ura dneva (0–23). |
tt | Minuta ure (0–59). |
ss | Sekunde minute (0–59). |
am | Čas označi kot am ali pm (nasprotno od 24-urne ure). |
xs:datetime | Nakazuje datum in čas v formatu XML, ko je opisano v shemi W3C XML in ISO 8601. Format je naslednji: CCYY-MM-DDThh:mm:ss Prisotna morajo biti vsa polja, pred njimi pa je so želji lahko predznak in začetne številke, sledijo pa jim števke ulomka za sekunde in časovno cono. Časovno cono je mogoče podati s črko "Z", ki identificira UTC ali razliko z UTC-jem. |
Ločila
Naslednji simboli so veljavna ločila. Uporaba ločil je neobvezna.
Ločilo | Ločilo | Ločilo |
---|---|---|
, | . | / |
- | < | > |
? | : | | |
^ | ; | " |
[ | ] | { |
} | _ | = |
@ | % | + |
( | ) | * |
& | # | <presledek> |
Vzorci
- Sreda, 8. junij 2000 ob 32 sekund čez 14:05.
Maska | Rezultati |
---|---|
|
jun. 8, 2000 |
|
junij 8, 2000 |
|
jun 8, 00 (sre) |
|
140532 |
|
02:05 pm |
|
8-6-00, 14:05 |
|
6/8/2000, 02:05:032 pm |
|
167, 14:05:32 |
|
05:32 pm |
|
2000-06-08T14:05:32 |