Pomoć:Vremenska funkcija

Izvor: Wikipedija
Prijeđi na navigaciju Prijeđi na pretraživanje
11:29
(CEST)
utorak, 18. lipnja 2019.
25. tjedan
169. dan u godini
Primjer primjene funkcije

Vremenska funkcija je funkcija parsera koja služi za oblikovanje prikazivanje 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 VE | uredi]

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}} 09:29 — {{MJESNOVRIJEME}} 11:29.

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:

• 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. 11., a ako mu prethodi obrnuta kosa crta prikazat će se kao slovo {{#timel: 2016. \g. }} → 2016. g.).
• Stavljanjem čitavog izraza u navodnike (navodnici se ne prikazuju, npr. {{#timel: "''Ljeta Gospodnjeg''" Y. }}Ljeta Gospodnjeg 2019.).

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. 18.06.2019. 11:29:12 — June 18, 2019, 11:29:12 AM — 2019-06-18 11.29.12...), ali ne može sadržavati lokalne (hrvatske) nazive mjeseca (npr. {{#timel: d. F Y. | 18. lipnja 2019. }} 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 06, 6, June, Jun). 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 }} → 18. svibnja 2019. 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 }} → svibanj), 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: 18. июнь 2019.). Izostavljen parametar podrazumijeva jezik Wikipedije, odnosno oznaku hr za hrvatski jezik na ovoj Wikipediji.

Tablica kodova[uredi VE | uredi]

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 je dan 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. 2019 2019
y Godina s 2 znamenke. 19 19
L Vrijednost 1 ako je prijestupna godina, 0 ako nije. (primjer) 0 0
o ¹ Godina odgovarajućeg tjedna, prema ISO-8601 ² 2019 2019

¹ 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. 6 6
m Broj mjeseca, s vodećom nulom. 06 06
t Ukupan broj dana u mjesecu. 30 30
M Skraćeni naziv mjeseca, na lokalnom jeziku. lip lip
F Puni naziv mjeseca, na lokalnom jeziku.
(Vidjeti napomenu)
lipnja lipnja
xg Naziv mjeseca u genitivu, za jezike koji razlikuju oblik nominitiva i genitiva.
(Vidjeti napomenu)
lipanj lipanj
Tjedan
W Broj tjedna prema ISO 8601, s vodećom nulom. 25 25
Dan
j Dan u mjesecu, bez vodeće nule. 18 18
d Dan u mjesecu, s vodećom nulom. 18 18
z Dan u godini. Napomena: 1. siječnja = 0, dodati 1 za uobičajeno brojanje. (primjer) 168 168
D Skraćeni (troslovni) oblik naziva dana u tjednu. uto uto
l Puni oblik naziva dana u tjednu. utorak utorak
N Redni broj dana u tjednu, prema standardu ISO 8601 (ponedjeljak = 1, nedjelja = 7). 2 2
w Redni broj dana u tjednu (nedjelja = 0, subota = 6).
(Vidjeti napomenu)
2 2
Sati
a Vrijednost "am" (prijepodne) od 00:00:00 do 11:59:59), "pm" (poslijepodne) od 12:00:00 do 23:59:59. am am
A Vrijednost "AM" (prijepodne) od 00:00:00 do 11:59:59), "PM" (poslijepodne) od 12:00:00 do 23:59:59. AM AM
g 12-satni oblik vremena, bez vodeće nule. 9 11
h 12-satni oblik vremena, s vodećom nulom. 09 11
G 24-satni oblik vremena, bez vodeće nule. 9 11
H 24-satni oblik vremena, s vodećom nulom. 09 11
Minute i sekunde
i Minute u satu, s vodećom nulom. 29 29
s Sekunde u minuti, s vodećom nulom. 12 12
U Broj sekundâ od 1. siječnja 1970. 00:00:00 GMT (Unixovo računanje vremena; primjer za dobivanje vremena iz ovog broja) 1560850152 1560850152
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 1
O Razlika u odnosu na GMT. +0000 +0200
P Razlika u odnosu na GMT, s dvotočjem +00:00 +02:00
T Kratica vremenske zone. UTC CEST
Z Razlika u odnosu na GMT u sekundama. 0 7200
Ostalo
c Vrijeme formatirano prema ISO 8601, ekvivalentno Y-m-d"T"H:i:s+00:00. 2019-06-18T09:29:12+00:00 2019-06-18T11:29:12+02:00
r Vrijeme formatirano prema RFC 5322, ekvivalentno D, j M Y H:i:s +0000, ime dana i mjeseca nije internacionalizirano. Tue, 18 Jun 2019 09:29:12 +0000 Tue, 18 Jun 2019 11:29:12 +0200
Drugi kalendari
Islamski
xmj Dan u mjesecu. 14 14
xmF Puni naziv mjeseca. šèvāl šèvāl
xmn Broj mjeseca. 10 10
xmY Godina u punom obliku. 1440 1440
Iranski
xij Dan u mjesecu. 28 28
xiF Puni naziv mjeseca. hordada hordada
xin Broj mjeseca. 3 3
xiY Godina u punom obliku. 1398 1398
xiy Godina s 2 znamenke. 98 98
Hebrejski
xjj Dan u mjesecu. 15 15
xjF Puni naziv mjeseca. sivan sivan
xjt Ukupan broj dana u mjesecu. 30 30
xjx Naziv mjeseca u genitivu. sivana sivana
xjn Broj mjeseca. 9 9
xjY Godina u punom obliku. 5779 5779
Tajski solarni
xkY Godina u punom obliku.
Bulbgraph.svg Opaska: Za godine prije 1941. datumi u rasponu od siječ. do ožuj. nisu pravilno izračunati.
2562 2562
Minguoski/Juche
xoY Godina u punom obliku. 108 108
Japanski nengo
xtY Godina u punom obliku. 令和元 令和元
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.
  • Kôd w bi po definiciji trebao biti u rasponu 0-6, ali iz neznanog razloga daje isti rezultat kao kôd N.
  • 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 → 20:29
Ispravno je {{#timel: H:i | -270 min }} → 06:59 ili {{#timel: H:i | -16200 sec }} → 06:59, jer 11:29 - 4,5 sati = 06:59.

Primjeri[uredi VE | uredi]

  • 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:W. "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;'> (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)}} → 11:29, 18. lipnja 2019. (CEST). 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 2019. 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 ljetnog računanja vremena (CEST).
  • 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.
  • Izračunavanje dana u godini (dodati 1 na rezultat koda z):
{{#timel: j. F}} je {{#expr: {{#timel: z }} +1}}. dan u godini → 18. lipnja je 169. 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 11 sati,
xN: {{#timel:"vrijeme je" H i s — "vrijeme je" xN H i s xN | | hi }} → vrijeme je ११ २९ १२ — vrijeme je 11 29 12
  • Prikazivanje rimskim brojevima
Wikipedija {{#time: xrY }}. → Wikipedija MMXIX.
  • Prikazivanje hebrejskog kalendara
Primjer pokazuje dva načina pisanja
15 - 9 - 5779 — dobiveno kodom {{#timel: xjj - xjn - xjY}}
26 - 10 - 5780 — 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)