Funkcia vracia poradové číslo týždňa pre zadaný čas.
Deklarácia
INT %WeekNr(
TIME in time,
TEXT in timeZone := %GetCurrentTimeZone()
)
Parametre
time
Argument funkcie.
timeZone
Názov časového pásma pre prevod na lokálny čas (napr. "Europe/London") alebo definícia fixného posunu od UTC vo formáte "(+|-)hh[:mi[:ss]]", kdehhurčuje počet hodín,mipočet minút asspočet sekúnd. Znamienko posunu a počet hodín sú povinné časti definície posunu, počet minút a sekúnd sú volitelné a predvolene sú 0 (napr. "+02:30" definuje posun 2 hodiny a 30 minút od UTC). Prázdny text je interpretovaný rovnako ako volanie funkcie %GetCurrentTimeZone. Z historických dôvodov je akceptovaný aj celočíselný parameter, ktorý je interpretovaný nasledovne: 0 - zóna "Europe/London", 3600 - zóna "Europe/Bratislava", 7200 - zóna "Europe/Kiev", 21600 - zóna "Asia/Almaty". Použitie celočíselného parametra sa neodporúča a generuje upozornenie do logovacieho súboru!
Príklad
%WeekNr(SysTime) ; výsledkom je poradové číslo aktuálneho týždňa
Poznámka
Pre dátum 1. januára funkcia vracia hodnotu 1. Pre posledný týždeň v roku a prvý týždeň nasledujúceho roka, funkcia vracia rozdielne hodnoty aj napriek tomu, že v kalendári to môže byť ten istý týždeň.
Na zabránenie tejto nezrovnalosti odporúčame použiť funkciu %WeekOfYear.