Pomoć:Vremenska funkcija

Izvor: Wikipedija
14:35
(CET)
subota, 4. veljače 2023.
5. tjedan
35. dan u godini
Primjer primjene funkcije

Vremenska funkcija je funkcija parsera koja služi za oblikovanje prikazivanja vremena te za izračun vremena u formulama. Može imati dva oblika, #time ili #timel.

Ova se funkcija najčešće rabi na posebnim stranicama, kao što su na primjer Glavna stranica ili predlošci. Zbog veće fleksibilnosti rabi se kao dopuna ili zamjena za vremenske varijable.

Uporaba[uredi | uredi kôd]

Osnovni oblik funkcije #time uzima datum i vrijeme sa servera (po gregorijanskom kalendaru) i oblikuje ga po zadanoj sintaksi.

Inačica #timel identična je funkciji #time, osim što uzima lokalni datum i vrijeme, analogno varijablama {{MJESN*}} u odnosu na {{TRENUTAČN*}}, na primjer {{TRENUTAČNOVRIJEME}} 13:35 — {{MJESNOVRIJEME}} 14:35.

U primjerima je naveden lokalni oblik funkcije #timel, koji se najčešće i rabi na ovoj Wikipediji.
(Većina primjera je "živa", s primijenjenom funkcijom, te po potrebi očistite cache za osvježavanje podataka.)

Funkcija se može rabiti u tri oblika sa sljedećim parametrima:

{{#timel: format }}
{{#timel: format | modifikacija }}
{{#timel: format | modifikacija | oznaka jezika }}

Parametri se mogu izostaviti, ali im se mora zadržati pozicija. (Parametar format također se može izostaviti, ali to nema smisla je se ništa neće prikazati, npr. {{#timel: |+2 weeks|hr}} nema nikakav učinak.)

format - U donjoj tablici kodova je popis svih kodova čijom se kombinacijom dobiva željeni oblik. Često (skoro uvijek) će se uz kodove rabiti dodatni znaci ili tekst. Propuštaju se i prikazuju svi znaci koji nisu navedeni u tablici kodova, uključujući i razmak. Ako se slova iz kôda trebaju ubaciti kao tekst, to se može postići na dva načina:

  1. Za ubacivanje samo jednog znaka ispred njega napisati obrnutu kosu crtu (npr. kôd g prikazuje broj sati u 12-satnom obliku bez vodeće nule: {{#timel: 2016. g. }} → 2016. 2., a ako mu prethodi obrnuta kosa crta prikazat će se kao slovo {{#timel: 2016. \g. }} → 2016. g.).
  2. Stavljanjem čitavog izraza u navodnike, npr. {{#timel: "''Ljeta Gospodnjeg''" Y. }}Ljeta Gospodnjeg 2023.
    Navodnici se ne prikazuju, ali se u slučaju potrebe mogu navesti kao što je opisano u prvom načinu: \""neki tekst"\" (izvan navodnika) te kao kôd " ili kao HTML element " (u navodnicima).

modifikacija - Ako se ovaj parametar ne navede, podrazumijeva se tekuće vrijeme (vrijednost now koja se može izostaviti), a modifikacija dopušta neko drugo vrijeme koje će se pokazati. Može se navesti u apsolutnoj ili relativnoj vrijednosti.

  • Apsolutna vrijednost navodi se u nekom obliku koji se međunarodno koristi za ispisivanje datuma i vremena (npr. 04.02.2023. 14:35:15 — February 4, 2023, 2:35:15 PM — 2023-02-04 14.35.15...), ali ne može sadržavati lokalne (hrvatske) nazive mjeseca (npr. {{#timel: d. F Y. | 04. veljače 2023. }} dat će grešku jer nije prepoznato kao valjani datum), već se mjesec mora navesti brojem (sa ili bez vodeće nule), ili engleskim nazivom, ili skraćenicom (npr. za ovaj mjesec 02, 2, February, Feb). Ako se apsolutna vrijednost navede djelomično, nedostajući podatci (neki, ali ne svi) dopunit će se iz tekućih podataka (npr. {{#time: d. F Y. H:i:s | May }} → 04. svibnja 2023. 00:00:00, dopunjeno je tekućim danom i godinom, ali je prikazan početak dana a ne trenutačno vrijeme).
  • Relativna vrijednost također prihvaća samo engleske nazive (svejedno u jednini ili množini, a za sekunde i minute moguć je duži ili kraći oblik):
    • sec [secs/second/seconds] - sekunda
    • min [mins/minute/minutes] - minuta
    • hour(s) - sat
    • day(s) - dan
    • week(s) - tjedan
    • month(s) - mjesec
    • year(s) - godina
Samostalno navedena vrijednost odnosi se na tekuće vrijeme (npr. jedan mjesec prije ovoga mjeseca {{#timel: xg | -1 month }} → siječanj), a može se rabiti i u kombinaciji s apsolutnom vrijednošću (npr. jedan mjesen nakon listopada {{#timel: xg | 03.10.1954. +1 month }} → studeni).
Razmak između modifikatora se ignorira, tako da je svejedno napišete li {{#time: d. F Y. H:i:s |+1month+3days-1year-2hours}} ili {{#time: d. F Y. H:i:s |+1month + 3 days -1 year -2hours}}.
Obratite pažnju na gornje primjere u kojima se rabi kôd xg umjesto F za prikazivanje naziva mjeseca u nominativu. Razlog je naveden u napomeni ispod tablice kodova.

oznaka jezika - ako se navede dvoslovni kôd jezika prema standardu ISO 639-1 (de, ru...) format će se prikazati u navedenom jeziku (npr. {{#timel: "ruski:" d. F Y. | |ru}} → ruski: 04. февраль 2023.). Izostavljen parametar podrazumijeva jezik Wikipedije, odnosno oznaku hr za hrvatski jezik na ovoj Wikipediji.

Tablica kodova[uredi | uredi kôd]

Sljedeća tablica sadržava popis kodova koji se rabe u oblikovanju datuma i vremena. Prilagođena je ovoj Wikipediji, a preuzeta je sa stranice na engleskoj Wikipediji (koja je pak preuzeta s MediaWiki stranice mw:Help:Extension:ParserFunctions#time).

Ispis rezultata dan je kako ih funkcija proizvodi, razgodci (npr. točka iza godine, dvotočje između sati i minuta, zarez u odvajanju imena dana) dodaju se kao tekst.

Kôd Opis Djelovanje (tekući rezultat)
(očistite cache za ažuriranje)
#time #timel
Godina
Y Godina s 4 znamenke. 2023 2023
y Godina s 2 znamenke. 23 23
L Vrijednost 1 ako je prijestupna godina, 0 ako nije. (primjer) 0 0
o ¹ Godina odgovarajućeg tjedna, prema ISO-8601 ² 2023 2023

¹ Minimalno PHP 5.1.0 i rev:45208. Ako uvjeti nisu ispunjeni, prikazuje se slovo "o"
² Prikazuje se godina kojoj pripada broj tjedna (W). (primjer)

Mjesec
n Broj mjeseca, bez vodeće nule. 2 2
m Broj mjeseca, s vodećom nulom. 02 02
t Ukupan broj dana u mjesecu. 28 28
M Skraćeni naziv mjeseca, na lokalnom jeziku. velj velj
F Puni naziv mjeseca, na lokalnom jeziku.
(Vidjeti napomenu)
veljače veljače
xg Naziv mjeseca u genitivu, za jezike koji razlikuju oblik nominitiva i genitiva.
(Vidjeti napomenu)
veljača veljača
Tjedan
W Broj tjedna prema ISO 8601, s vodećom nulom. 05 05
Dan
j Dan u mjesecu, bez vodeće nule. 4 4
d Dan u mjesecu, s vodećom nulom. 04 04
z Dan u godini. Napomena: 1. siječnja = 0, dodati 1 za uobičajeno brojenje. (primjer) 34 34
D Skraćeni (troslovni) oblik naziva dana u tjednu. sub sub
l Puni oblik naziva dana u tjednu. subota subota
N Redni broj dana u tjednu, prema standardu ISO 8601 (ponedjeljak = 1, nedjelja = 7). 6 6
w Redni broj dana u tjednu (nedjelja = 0, subota = 6). 6 6
Sati
a Vrijednost "am" (prijepodne) od 00:00:00 do 11:59:59, "pm" (poslijepodne) od 12:00:00 do 23:59:59. pm pm
A Vrijednost "AM" (prijepodne) od 00:00:00 do 11:59:59, "PM" (poslijepodne) od 12:00:00 do 23:59:59. PM PM
g 12-satni oblik vremena, bez vodeće nule. 1 2
h 12-satni oblik vremena, s vodećom nulom. 01 02
G 24-satni oblik vremena, bez vodeće nule. 13 14
H 24-satni oblik vremena, s vodećom nulom. 13 14
Minute i sekunde
i Minute u satu, s vodećom nulom. 35 35
s Sekunde u minuti, s vodećom nulom. 15 15
U Broj sekundâ od 1. siječnja 1970. 00:00:00 GMT (Unixovo računanje vremena; primjer za dobivanje vremena iz ovog broja) 1675517715 1675517715
Vremenska zona
e Oznaka vremenske zone. UTC Europe/Berlin
I Vrijednost 1 ako je datum u zimskom računanju vremena, 0 u ljetnom. (primjer) 0 0
O Razlika u odnosu na GMT. +0000 +0100
P Razlika u odnosu na GMT, s dvotočjem +00:00 +01:00
T Kratica vremenske zone. UTC CET
Z Razlika u odnosu na GMT u sekundama. 0 3600
Ostalo
c Vrijeme formatirano prema ISO 8601, ekvivalentno Y-m-d"T"H:i:s+00:00. 2023-02-04T13:35:15+00:00 2023-02-04T14:35:15+01:00
r Vrijeme formatirano prema RFC 5322, ekvivalentno D, j M Y H:i:s +0000, ime dana i mjeseca nije internacionalizirano. Sat, 04 Feb 2023 13:35:15 +0000 Sat, 04 Feb 2023 14:35:15 +0100
Drugi kalendari
Islamski
xmj Dan u mjesecu. 13 13
xmF Puni naziv mjeseca. rèdžeb rèdžeb
xmn Broj mjeseca. 7 7
xmY Godina u punom obliku. 1444 1444
Iranski
xij Dan u mjesecu. 15 15
xiF Puni naziv mjeseca. bahmana bahmana
xin Broj mjeseca. 11 11
xiY Godina u punom obliku. 1401 1401
xiy Godina s 2 znamenke. 01 01
Hebrejski
xjj Dan u mjesecu. 13 13
xjF Puni naziv mjeseca. ševat ševat
xjt Ukupan broj dana u mjesecu. 30 30
xjx Naziv mjeseca u genitivu. ševata ševata
xjn Broj mjeseca. 5 5
xjY Godina u punom obliku. 5783 5783
Tajski solarni
xkY Godina u punom obliku.
Opaska: Za godine prije 1941. datumi u rasponu od siječnja do ožujka nisu pravilno izračunati.
2566 2566
Minguoski/Juche
xoY Godina u punom obliku. 112 112
Japanski nengo
xtY Godina u punom obliku. 令和5 令和5
Predznak x
xn Sljedeći numerički kôd formatira kao ASCII broj. (primjer)
xN Slično kao xn, ali djeluje na cijeli niz ili do sljedeće oznake xN. (primjer)
xr Prikazuje sljedeći broj kao rimski broj (vrijedi za brojeve do 10.000). (primjer)
xh Prikazuje sljedeći broj kao Hebrejski broj. (primjer)

Napomene:

  • Na hrvatskoj Wikipediji su, prije uvođenja genitivnog oblika mjesecâ u softver, definirani genitivni oblici mjeseca u odgovarajućim MediaWiki datotekama i to je bez velike intervencije nemoguće ispraviti (rabe se na puno mjesta). Stoga pri uporabi kodove xg i F treba međusobno zamijeniti, odnosno za oblik u genitivu rabiti F, a za oblik u nominativu rabiti xg.
  • Zbog buga u funkciji, modifikacija vremenske zone prihvaća samo cijele brojeve (za pune sate). Rješenje za zaobilaženje je modifikaciju izraziti u minutama ili sekundama.
Rezultat koda {{#timel: H:i | -4.5 hours }} je neispravan: 14:35 -4,5 sati ≠ 23:35
Ispravno je {{#timel: H:i | -270 min }} → 10:05 ili {{#timel: H:i | -16200 sec }} → 10:05, jer 14:35 - 4,5 sati = 10:05.

Primjeri[uredi | uredi kôd]

  • Sljedećim wikitekstom urađen je primjer s vrha stranice (koji, recimo, možete kopirati i postaviti na vašu suradničku stranicu):
{| style="float: right; border: solid 3px gray; border-collapse: collapse; text-align: center; margin: 10px; font-weight: bold;"
| style="font-size: 16px; margin: 10px; background-color: whitesmoke; padding: 5px; " | {{#timel: H:i}} <br><span style="font-size: 70%;> {{#timel: (T)}} </span>
|-
| style="background-color: navy; color: yellow; font-size: 16px; padding: 5px;" | {{#timel: l, j. F Y.}}
|-
| style="background-color: whitesmoke;" | {{#timel:{{#expr: {{#timel: W }} *1}}. "tjedan"{{#ifexpr: {{#timel:Y}} = {{#timel:o}} | <!-- prazno: tjedan je u tekućoj godini--> | <!-- tjedan nije u tekućoj godini, prikazati u kojoj je -->"<span style='font-weight: normal;'>&nbsp;(u" {{#timel:o.}} "godini)</span>"}} }}
|-
| style="background-color: whitesmoke;" | {{#expr: {{#timel: z }} +1}}. dan u godini
|-
| style="font-weight: bold; font-size: 10px; border-top: 1px solid gray;" | [[#primjer|Primjer primjene funkcije]]
|}
  • Vrijeme kako se prikazuje u potpisima može se dobiti sljedećim izrazom:
{{#timel: H:i, j. F Y. (T)}} → 14:35, 4. veljače 2023. (CET). Na isti se način pokazuje i vrijeme u povijesti izmjena, osim što je izostavljena vremenska zona.
  • Prikazivanje prijestupne godine, obuhvaća i primjer uporabe u izrazu
{{#ifexpr: {{#timel:L}}= 1 | godina {{#timel:Y.}} je prijestupna | godina {{#timel:Y.}} nije prijestupna}} → godina 2023. nije prijestupna.
  • Prikazivanje je li datum u ljetnom ili zimskom računanju vremena
{{#ifexpr: {{#timel: I }}= 1 | datum je u periodu ljetnog računanja vremena (CEST) | datum je u periodu zimskog računanja vremena (CET) }}. → datum je u periodu zimskog računanja vremena (CET).
  • Primjer određivanja godine prema broju tjedna
Prema ISO definiciji, prvi tjedan u godini je prvi tjedan koji u sebi ima četvrtak. Tako je 1. siječnja 2016. pripadao 53. tjednu 2015. jer je prvi četvrtak bio 7. siječnja 2016.
Funkcija s kôdom Y je stoga pogrešna jer daje tjedan u tekućoj godini {{#timel: W. "tjedan" Y. | 1.1.2016. }} → 53. tjedan 2016., a funkcija s kôdom o daje točnu godinu u kojoj se tjedan nalazi {{#timel: W. "tjedan" o. | 1.1.2016.}} → 53. tjedan 2015.
Isto tako, 31. prosinca 2014. bio je u prvom tjednu 2015. godine, te je i u tom slučaju funkcija s kôdom Y pogrešna, a s kôdom o ispravna:
{{#timel: W. "tjedan" Y. | 31.12.2014. }} → 01. tjedan 2014. — {{#timel: W. "tjedan" o. | 31.12.2014. }} → 01. tjedan 2015.
  • Jednoznamenkast broj tjedna:
Kôd W daje dvoznamenkast broj tjedna u godini te su tjedni 1-9 s vodećom nulom. Vodeća nula može se ukloniti sledećim trikom (rezultat funkcije pomnožiti s 1):
{{#timel: j. F Y. "je u" {{#expr: {{#timel: W }} *1}}. "tjednu"| 4.2.2020.}} → 4. veljače 2020. je u 5. tjednu.
  • Izračunavanje dana u godini (dodati 1 na rezultat koda z):
{{#timel: j. F}} je {{#expr: {{#timel: z }} +1}}. dan u godini → 4. veljače je 35. dan u godini.
  • Prikazivanje ASCII broja:
U hindskom jeziku:
xn: {{#timel:"sada je" H "sati" - "sada je" xn H "sati" | | hi }} → sada je १४ sati - sada je 14 sati,
xN: {{#timel:"vrijeme je" H i s — "vrijeme je" xN H i s xN | | hi }} → vrijeme je १४ ३५ १५ — vrijeme je 14 35 15
  • Prikazivanje rimskim brojevima
Wikipedija {{#time: xrY }}. → Wikipedija MMXXIII.
  • Prikazivanje hebrejskog kalendara
Primjer pokazuje dva načina pisanja
13 - 5 - 5783 — dobiveno kodom {{#timel: xjj - xjn - xjY}}
24 - 13 - 5784 — dobiveno kodom {{#timel: xjj - xjn - xjY|+1 month +1 year}}
Navođenjem kôda xh* umjesto xj* dobiva se ispis hebrejskim brojevima:
ד' - ב' - ב'כ"ג — dobiveno kodom {{#timel: xhj - xhn - xhY}}
ד' - ג' - ב'כ"ד — dobiveno kodom {{#timel: xhj - xhn - xhY|+1 month +1 year}}
  • Primjer dobrodošlice prema dobu dana
Sljedeći wikitekst prema dobu dana pokazuje odgovarajući pozdrav - "dobro jutro" od 2 do 10 sati, "dobar dan" od 10 do 18 sati, te "dobra večer" u ostalo vrijeme: Dobar dan i dobro došli na Wikipediju!
{{#ifexpr: {{#timel:G}} < 2 | Dobra večer | {{#ifexpr: {{#timel:G}} < 10 | Dobro jutro | {{#ifexpr: {{#timel:G}} < 18 | Dobar dan | Dobra večer }} }} }} i dobro došli na Wikipediju!
  • Unixova oznaka vremena
Unixova oznaka vremena je cijeli broj koji predstavlja broj sekundâ prije (negativan broj) i nakon (pozitivan broj) 00:00:00 GMT 1. siječnja 1970. (četvrtak). Wikipedija interno sva vremena bilježi u ovom obliku i preko njih vrši izračunavanja. Za dobivanje "čitljivog" vremena, to se vrijeme stavlja kao modifikacija funkcije navođenjem znaka @ ispred oznake:
{{#time: D H:i:s, j. F Y. (T) | @0 }} → čet 00:00:00, 1. siječnja 1970. (UTC) (početno vrijeme, funkcija #time)
{{#timel: D H:i:s, j. F Y. (T) | @1234567890 }} → sub 00:31:30, 14. veljače 2009. (CET)
{{#timel: D H:i:s, j. F Y. (T) | @-1234567890 }} → uto 01:28:30, 18. studenoga 1930. (CET)