Pomoć:Vremenska funkcija

Izvor: Wikipedija
Prijeđi na navigaciju Prijeđi na pretraživanje
17:23
(CEST)
četvrtak, 16. srpnja 2020.
29. tjedan
198. 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 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}} 15:23 — {{MJESNOVRIJEME}} 17:23.

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. 5., 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 2020.
    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. 16.07.2020. 17:23:05 — July 16, 2020, 5:23:05 PM — 2020-07-16 17.23.05...), ali ne može sadržavati lokalne (hrvatske) nazive mjeseca (npr. {{#timel: d. F Y. | 16. srpnja 2020. }} 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 07, 7, July, Jul). 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 }} → 16. svibnja 2020. 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 }} → lipanj), 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: 16. июль 2020.). 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 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. 2020 2020
y Godina s 2 znamenke. 20 20
L Vrijednost 1 ako je prijestupna godina, 0 ako nije. (primjer) 1 1
o ¹ Godina odgovarajućeg tjedna, prema ISO-8601 ² 2020 2020

¹ 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. 7 7
m Broj mjeseca, s vodećom nulom. 07 07
t Ukupan broj dana u mjesecu. 31 31
M Skraćeni naziv mjeseca, na lokalnom jeziku. srp srp
F Puni naziv mjeseca, na lokalnom jeziku.
(Vidjeti napomenu)
srpnja srpnja
xg Naziv mjeseca u genitivu, za jezike koji razlikuju oblik nominitiva i genitiva.
(Vidjeti napomenu)
srpanj srpanj
Tjedan
W Broj tjedna prema ISO 8601, s vodećom nulom. 29 29
Dan
j Dan u mjesecu, bez vodeće nule. 16 16
d Dan u mjesecu, s vodećom nulom. 16 16
z Dan u godini. Napomena: 1. siječnja = 0, dodati 1 za uobičajeno brojenje. (primjer) 197 197
D Skraćeni (troslovni) oblik naziva dana u tjednu. čet čet
l Puni oblik naziva dana u tjednu. četvrtak četvrtak
N Redni broj dana u tjednu, prema standardu ISO 8601 (ponedjeljak = 1, nedjelja = 7). 4 4
w Redni broj dana u tjednu (nedjelja = 0, subota = 6). 4 4
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. 3 5
h 12-satni oblik vremena, s vodećom nulom. 03 05
G 24-satni oblik vremena, bez vodeće nule. 15 17
H 24-satni oblik vremena, s vodećom nulom. 15 17
Minute i sekunde
i Minute u satu, s vodećom nulom. 23 23
s Sekunde u minuti, s vodećom nulom. 05 05
U Broj sekundâ od 1. siječnja 1970. 00:00:00 GMT (Unixovo računanje vremena; primjer za dobivanje vremena iz ovog broja) 1594912985 1594912985
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. 2020-07-16T15:23:05+00:00 2020-07-16T17:23:05+02:00
r Vrijeme formatirano prema RFC 5322, ekvivalentno D, j M Y H:i:s +0000, ime dana i mjeseca nije internacionalizirano. Thu, 16 Jul 2020 15:23:05 +0000 Thu, 16 Jul 2020 17:23:05 +0200
Drugi kalendari
Islamski
xmj Dan u mjesecu. 25 25
xmF Puni naziv mjeseca. zulkáde zulkáde
xmn Broj mjeseca. 11 11
xmY Godina u punom obliku. 1441 1441
Iranski
xij Dan u mjesecu. 26 26
xiF Puni naziv mjeseca. tira tira
xin Broj mjeseca. 4 4
xiY Godina u punom obliku. 1399 1399
xiy Godina s 2 znamenke. 99 99
Hebrejski
xjj Dan u mjesecu. 24 24
xjF Puni naziv mjeseca. tamuz tamuz
xjt Ukupan broj dana u mjesecu. 29 29
xjx Naziv mjeseca u genitivu. tamuza tamuza
xjn Broj mjeseca. 10 10
xjY Godina u punom obliku. 5780 5780
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.
2563 2563
Minguoski/Juche
xoY Godina u punom obliku. 109 109
Japanski nengo
xtY Godina u punom obliku. 令和2 令和2
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: 17:23 -4,5 sati ≠ 02:23
Ispravno je {{#timel: H:i | -270 min }} → 12:53 ili {{#timel: H:i | -16200 sec }} → 12:53, jer 17:23 - 4,5 sati = 12:53.

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:{{#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)}} → 17:23, 16. srpnja 2020. (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 2020. je 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.
  • 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 29. tjednu.
  • Izračunavanje dana u godini (dodati 1 na rezultat koda z):
{{#timel: j. F}} je {{#expr: {{#timel: z }} +1}}. dan u godini → 16. srpnja je 198. 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 17 sati,
xN: {{#timel:"vrijeme je" H i s — "vrijeme je" xN H i s xN | | hi }} → vrijeme je १७ २३ ०५ — vrijeme je 17 23 05
  • Prikazivanje rimskim brojevima
Wikipedija {{#time: xrY }}. → Wikipedija MMXX.
  • Prikazivanje hebrejskog kalendara
Primjer pokazuje dva načina pisanja
24 - 10 - 5780 — dobiveno kodom {{#timel: xjj - xjn - xjY}}
8 - 12 - 5781 — 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)