Funktion date

Die Funktion date gibt ein Datum in einem bestimmten Format aus. Der erste Parameter ist das Format, der zweite optionale Parameter - der Zeitpunkt im Timestamp-Format. Wenn der zweite Parameter nicht angegeben ist, wird der aktuelle Zeitpunkt verwendet, falls angegeben - der angegebene.

Das Format wird durch Steuerbefehle (englische Buchstaben) festgelegt, wobei beliebige Trennzeichen zwischen ihnen eingefügt werden können (Bindestriche, Doppelpunkt usw.).

Die Funktion akzeptiert die folgenden Befehle (Großbuchstaben unterscheiden sich von Kleinbuchstaben, bitte beachten):

U – Anzahl der Sekunden seit dem 1. Januar 1970 (also Timestamp).
z – Tag des Jahres.
Y – Jahr, 4 Ziffern.
y - Jahr, zwei Ziffern.
m – Monatsnummer (mit vorangestellter Null).
n – Monatsnummer ohne vorangestellte Null.
d – Tag des Monats, immer zwei Ziffern (die erste kann also eine Null sein).
j – Tag des Monats ohne vorangestellte Null.
w – Wochentag (0 - Sonntag, 1 - Montag usw.).
h – Stunde im 12-Stunden-Format.
H – Stunde im 24-Stunden-Format.
i – Minuten.
s – Sekunden.
L – 1, wenn Schaltjahr, 0, wenn kein Schaltjahr.
W – Kalenderwoche des Jahres.
t – Anzahl der Tage im angegebenen Monat.

Syntax

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

Beispiele für die Arbeit mit date

<?php
	// Alle Beispiele gelten für das Datum 01.06.2013 um 12:23:59, Montag
	
	echo date('Y'); // gibt '2013' aus
	echo date('y'); // gibt '13' aus
	echo date('m'); // gibt '06' aus - Monatsnummer
	echo date('d'); // gibt '01' aus - Tag des Monats
	echo date('j'); // gibt '1'  aus - Tag des Monats (ohne vorangestellte Null)
	echo date('w'); // gibt '1'  aus - Montag
	echo date('H'); // gibt '12' aus - Stunden
	echo date('i'); // gibt '23' aus - Minuten
	echo date('s'); // gibt '59' aus - Sekunden
	
	echo date('d-m-Y'); // gibt '01-06-2013' aus
	echo date('d.m.Y'); // gibt '01.06.2013' aus
	echo date('H:i:s d.m.Y'); // gibt '12:23:59 01.06.2013' aus
?>

Zweiter Parameter der Funktion date

Die Funktion date hat einen zweiten optionalen Parameter, der einen Zeitpunkt im Timestamp-Format akzeptiert. Wenn dieser Parameter übergeben wird, formatiert die Funktion date nicht den aktuellen Zeitpunkt, sondern den, der als zweiter Parameter übergeben wurde. Diesen timestamp kann man z.B. mit mktime erhalten (muss aber nicht):

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

Dies kann genutzt werden, um den Wochentag für ein bestimmtes Datum herauszufinden - einfach das Datum als zweiten Parameter mit der Funktion mktime übergeben und als ersten Parameter das Steuerzeichen 'w' setzen:

<?php
	// Welcher Wochentag war der 29.12.2013:
	echo date('w', mktime(0, 0, 0, 12, 29, 13)); // gibt '0' aus - Sonntag
?>

Siehe auch

die Funktion mktime,
die einen Zeitpunkt im Timestamp-Format zurückgibt