Funkcija date

Funkcija date išveda datą nurodytu formatu. Pirmu parametru funkcija priima formatą, o antru pasirinktiniu parametru - laiko momentą timestamp formatu. Jei antras parametras nenurodytas - bus paimtas dabartinis laiko momentas, jei nurodytas - tai nurodytas.

Formatas nurodomas valdymo komandomis (anglų raidėmis), tuo tarpu galima įterpti bet kokius skiriamuosius ženklus tarp jų (brūkšnelius, dvitaškį ir pan.).

Funkcija priima šias komandas (didžiosios raidės skiriasi nuo mažųjų, atkreipkite dėmesį):

• U – sekundžių skaičius, praėjęs nuo 1 sausio 1970 metų (tai yra timestamp).
• z – metų dienos numeris.
• Y – metai, 4 skaitmenys.
• y - metai, du skaitmenys.
• m – mėnesio numeris (su nuliu priekyje).
• n – mėnesio numeris be priekyje esančio nulio.
• d – mėnesio dienos numeris, visada du skaitmenys (tai yra pirmasis gali būti nulis).
• j – mėnesio dienos numeris be priešakyje esančio nulio.
• w – savaitės diena (0 - sekmadienis, 1 - pirmadienis ir t.t.).
• h – valandos 12-valandų formatu.
• H – valandos 24-valandų formatu.
• i – minutės.
• s – sekundės.
• L – 1, jei keliamieji metai, 0, jei ne keliamieji.
• W – eilinis metų savaitės numeris.
• t – dienų skaičius nurodytą mėnesį.

Sintaksė

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

Pavyzdžiai su date

php<?php
  // Visi pavyzdžiai rodomi datai 01.06.2013 12.23.59, pirmadienis
  
  echo date('Y'); // išves '2013'
  echo date('y'); // išves '13'
  echo date('m'); // išves '06' - mėnesio numeris
  echo date('d'); // išves '01' - mėnesio dienos numeris
  echo date('j'); // išves '1'  - mėnesio dienos numeris (be nulio priekyje)
  echo date('w'); // išves '1'  - pirmadienis
  echo date('H'); // išves '12' - valandos
  echo date('i'); // išves '23' - minutės
  echo date('s'); // išves '59' - sekundės
  
  echo date('d-m-Y'); // išves '01-06-2013'
  echo date('d.m.Y'); // išves '01.06.2013'
  echo date('H:i:s d.m.Y'); // išves '12:23:59 01.06.2013'
?>

Antras funkcijos date parametras

Funkcija date turi antrą pasirinktinį parametrą, kuris priima laiko momentą timestamp formatu. Jei perduosite šį parametrą, tai funkcija date suformatuos ne dabartinį laiko momentą, o tą, kuris perduotas antru parametru. Šį timestamp galima gauti, pavyzdžiui, per mktime (bet nebūtinai):

php<?php
  echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // išves '29-12-2013'
?>

Tai galima panaudoti, norint sužinoti savaitės dienos numerį už tam tikrą datą - tiesiog perduokime ją antru parametru su pagalba funkcijos mktime, o pirmu parametru padėkime valdymo simbolį 'w':

php<?php
  // Sužinokime kokia savaitės diena buvo 29-12-2013:
  echo date('w', mktime(0, 0, 0, 12, 29, 13)); // išves '0' - sekmadienis
?>

Taip pat žiūrėkite