Funktionen date

Funktionen date udskriver en dato i det ønskede format. Som første parameter tager funktionen formatet, og som anden valgfri parameter - et tidspunkt i timestamp-format. Hvis den anden parameter ikke er angivet, bruges det nuværende tidspunkt, og hvis den er angivet, bruges det specificerede.

Formatet angives med styrekommandoer (engelske bogstaver), og man kan indsætte vilkårlige adskillelser mellem dem (bindestreger, kolon osv.).

Funktionen accepterer følgende kommandoer (bemærk at store bogstaver adskiller sig fra små):

U – antal sekunder, der er gået siden 1 januar 1970 (dvs. timestamp).
z – dagsnummer fra årets begyndelse.
Y – år, 4 cifre.
y - år, to cifre.
m – månedsnummer (med foranstillet nul).
n – månedsnummer uden foranstillet nul.
d – dagsnummer i måneden, altid to cifre (den første kan altså være nul).
j – dagsnummer i måneden uden foranstillet nul.
w – ugedag (0 - søndag, 1 - mandag osv.).
h – timer i 12-timers format.
H – timer i 24-timers format.
i – minutter.
s – sekunder.
L – 1, hvis skudår, 0, hvis ikke skudår.
W – ugenummer i året.
t – antal dage i den angivne måned.

Syntaks

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

Eksempler på brug af date

<?php
	// Alle eksempler er vist for datoen 01.06.2013 kl. 12.23.59, mandag
	
	echo date('Y'); // udskriver '2013'
	echo date('y'); // udskriver '13'
	echo date('m'); // udskriver '06' - månedsnummer
	echo date('d'); // udskriver '01' - dagsnummer i måneden
	echo date('j'); // udskriver '1'  - dagsnummer i måneden (uden foranstillet nul)
	echo date('w'); // udskriver '1'  - mandag
	echo date('H'); // udskriver '12' - timer
	echo date('i'); // udskriver '23' - minutter
	echo date('s'); // udskriver '59' - sekunder
	
	echo date('d-m-Y'); // udskriver '01-06-2013'
	echo date('d.m.Y'); // udskriver '01.06.2013'
	echo date('H:i:s d.m.Y'); // udskriver '12:23:59 01.06.2013'
?>

Anden parameter for funktionen date

Funktionen date har en anden valgfri parameter, som accepterer et tidspunkt i timestamp-format. Hvis denne parameter sendes med, vil funktionen date formatere ikke det nuværende tidspunkt, men det som sendes med som anden parameter. Dette timestamp kan fås, for eksempel, via mktime (men ikke nødvendigvis):

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

Dette kan bruges til at finde ud af ugedagen for en bestemt dato - blot send datoen som anden parameter ved hjælp af funktionen mktime, og som første parameter angiv styresymbolet 'w':

<?php
	// Lad os finde ud af hvilken ugedag den 29-12-2013 var:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // udskriver '0' - søndag
?>

Se også

funktionen mktime,
som returnerer et tidspunkt i timestamp-format