Funktsioon date

Funktsioon date väljastab kuupäeva etteantud vormingus. Esimese parameetrina võtab funktsioon vormingu, ja teise valikulise parameetrina - ajahetke timestamp'i vormingus. Kui teist parameetrit ei määrata - võetakse praegune ajahetk, kui määratakse - siis etteantud.

Vorming määratakse juhtkäskude (inglise tähtedega), samas saab nende vahele panna suvalisi eraldajaid (kriipsud, koolon jne).

Funktsioon aktsepteerib järgmisi käske (suurtähed erinevad tavapärastest, pöörake tähelepanu):

• U – sekundite arv, mis on möödunud 1. jaanuarist 1970 (st timestamp).
• z – aasta päeva number (alustades 0-st).
• Y – aasta, 4 numbrit.
• y - aasta, kaks numbrit.
• m – kuu number (eespool oleva nulliga).
• n – kuu number ilma ees oleva nullita.
• d – päeva number kuus, alati kaks numbrit (st esimene võib olla null).
• j – päeva number kuus ilma eelneva nullita.
• w – nädalapäev (0 - pühapäev, 1 - esmaspäev jne).
• h – tunnid 12-tunnilises vormingus.
• H – tunnid 24-tunnilises vormingus.
• i – minutid.
• s – sekundid.
• L – 1, kui liigaasta, 0, kui mitte liigaasta.
• W – aasta nädala järjekorranumber.
• t – päevade arv määratud kuus.

Süntaks

phpdate(string $format, ?int $timestamp = null): string

Näited date'i kasutamisest

php<?php
  // Kõik näited on näidatud kuupäeva 01.06.2013 kohta kell 12.23.59, esmaspäev
  
  echo date('Y'); // väljastab '2013'
  echo date('y'); // väljastab '13'
  echo date('m'); // väljastab '06' - kuu number
  echo date('d'); // väljastab '01' - päeva number kuus
  echo date('j'); // väljastab '1'  - päeva number kuus (ilma ees oleva nullita)
  echo date('w'); // väljastab '1'  - esmaspäev
  echo date('H'); // väljastab '12' - tunnid
  echo date('i'); // väljastab '23' - minutid
  echo date('s'); // väljastab '59' - sekundid
  
  echo date('d-m-Y'); // väljastab '01-06-2013'
  echo date('d.m.Y'); // väljastab '01.06.2013'
  echo date('H:i:s d.m.Y'); // väljastab '12:23:59 01.06.2013'
?>

Funktsiooni date teine parameeter

Funktsioonil date on teine valikuline parameeter, mis võtab ajahetke timestamp'i vormingus. Kui seda parameetrit edastada, siis funktsioon date vormindab mitte praeguse ajahetke, vaid selle, mis on edastatud teise parameetrina. Selle timestamp'i saab näiteks kätte funktsiooniga mktime (kuid mitte tingimata):

php<?php
  echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // väljastab '29-12-2013'
?>

Seda saab kasutada, et teada saada nädalapäeva number kindla kuupäeva kohta - lihtsalt edastame selle teise parameetrina abiga funktsioonist mktime, ja esimeseks parameetriks paneme juhtsümboli 'w':

php<?php
  // Uurime, mis nädalapäev oli 29-12-2013:
  echo date('w', mktime(0, 0, 0, 12, 29, 13)); // väljastab '0' - pühapäev
?>

Vaata ka