IBM FileNet P8, Version 5.2.1            

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.

Tabela 1. Komponente maske datum/čas
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.

Tabela 2. Tabela veljavnih simbolov za ločila
Ločilo Ločilo Ločilo
, . /
- < >
? : |
^ ; "
[ ] {
} _ =
@ % +
( ) *
& # <presledek>

Vzorci

V vseh primerih je čas naslednji:
  • Sreda, 8. junij 2000 ob 32 sekund čez 14:05.
Tabela 3. Tabela mask datuma in časa ter rezultati za primer
Maska Rezultati
"mon. dd, yyyy"
jun. 8, 2000
"month dd, yyyy"
junij 8, 2000
"mon dd, yy (day)"
jun 8, 00 (sre)
''hhttss"
140532
"hh:tt am"
02:05 pm
"dd-mm-yy, hh:tt"
8-6-00, 14:05
"mm/dd/yyyy, hh:tt:ss am"
6/8/2000, 02:05:032 pm
"ddd, hh:tt:ss"
167, 14:05:32
"tt:ss am"
05:32 pm
"xs:datetime"
2000-06-08T14:05:32


Last updated: October 2015
bpfe019.htm

© Copyright IBM Corp. 2015.