Funkcia vracia poradové číslo týždňa pre zadaný čas.
Deklarácia
INT %WeekOfYear(
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!
Poznámka
Rozsah možných hodnôt funkcie je 1 až 53. Prvý týždeň v kalendári je prvý týždeň, v ktorom sú aspoň 4 dni z tohto kalendárneho roka.
Ak je posledný týždeň v roku a prvý týždeň nasledujúceho roka v rovnakom týždni, funkcia vráti rovnaké číslo pre obidva týždne (rovnako ako je označenie v kalendári).