Funkcija date

Funkcija date izvada datumu norādītajā formātā. Pirmo parametru funkcija saņem formātu, bet otro neobligāto parametru - laika momentu timestamp formātā. Ja otrais parametrs nav norādīts - tiks ņemts pašreizējais laika moments, ja norādīts - tad norādītais.

Formāts tiek norādīts ar vadības komandām (angļu burtiem), savukārt starp tām var ievietot jebkurus atdalītājus (domuzīmes, kolu un tā tālāk).

Funkcija pieņem šādas komandas (lielie burti atšķiras no mazajiem, pievērsiet uzmanību):

• U – sekunžu skaits, kas pagājis kopš 1. janvāra 1970. gada (tas ir, timestamp).
• z – dienas numurs kopš gada sākuma.
• Y – gads, 4 cipari.
• y - gads, divi cipari.
• m – mēneša numurs (ar nulli priekšā).
• n – mēneša numurs bez nulles priekšā.
• d – dienas numurs mēnesī, vienmēr divi cipari (tas ir, pirmais var būt nulle).
• j – dienas numurs mēnesī bez priekšā esošās nulles.
• w – nedēļas diena (0 - svētdiena, 1 - pirmdiena utt.).
• h – stundas 12-stundu formātā.
• H – stundas 24-stundu formātā.
• i – minūtes.
• s – sekundes.
• L – 1, ja garais gads, 0, ja nav garais gads.
• W – kārtas numurs nedēļai gadā.
• t – dienu skaits norādītajā mēnesī.

Sintakse

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

Darba piemēri ar date

php<?php
  // Visi piemēri parādīti datumam 01.06.2013 plkst. 12.23.59, pirmdiena
  
  echo date('Y'); // izvadīs '2013'
  echo date('y'); // izvadīs '13'
  echo date('m'); // izvadīs '06' - mēneša numurs
  echo date('d'); // izvadīs '01' - dienas numurs mēnesī
  echo date('j'); // izvadīs '1'  - dienas numurs mēnesī (bez nulles priekšā)
  echo date('w'); // izvadīs '1'  - pirmdiena
  echo date('H'); // izvadīs '12' - stundas
  echo date('i'); // izvadīs '23' - minūtes
  echo date('s'); // izvadīs '59' - sekundes
  
  echo date('d-m-Y'); // izvadīs '01-06-2013'
  echo date('d.m.Y'); // izvadīs '01.06.2013'
  echo date('H:i:s d.m.Y'); // izvadīs '12:23:59 01.06.2013'
?>

Funkcijas date otrais parametrs

Funkcijai date ir otrais neobligātais parametrs, kas saņem laika momentu timestamp formātā. Ja padod šo parametru, tad funkcija date formatēs ne pašreizējo laika momentu, bet to, kas ticis padots otrajā parametrā. Šo timestamp var iegūt, piemēram, ar mktime (bet ne obligāti):

php<?php
  echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // izvadīs '29-12-2013'
?>

To var izmantot, lai uzzinātu nedēļas dienas numuru konkrētam datumam - vienkārši padod to otrajā parametrā ar funkcijas mktime palīdzību, bet pirmajā parametrā ieliekam vadības simbolu 'w':

php<?php
  // Uzzināsim kāda nedēļas diena bija 29-12-2013:
  echo date('w', mktime(0, 0, 0, 12, 29, 13)); // izvadīs '0' - svētdiena
?>

Skatiet arī