DateTimeInterface::format
DateTimeImmutable::format
DateTime::format
date_format
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTimeInterface::format -- DateTimeImmutable::format -- DateTime::format -- date_format — Liefert das Datum formatiert gemäß dem angegebenen Format
Beschreibung
Objektorientierter Stil
$format): string$format): string$format): stringProzeduraler Stil
Gibt das Datum im angegebenen Format zurück.
Parameter-Liste
-
object -
Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebens DateTime Objekt.
-
format -
Das Format des ausgegebenen Datums vom Typ string. Siehe die Formatierungsoptionen unten. Es gibt auch mehrere vordefinierte Datumskonstanten, die stattdessen verwendet werden können, z.B. enthält
DATE_RSSdie Formatzeichenkette'D, d M Y H:i:s'.Die folgenden Zeichen werden in der Parameterzeichenkette formaterkanntformat-ZeichenBeschreibung Beispiel für zurückgegebene Werte Tag --- --- dTag des Monats; zwei Ziffern mit vorangestellter Null 01bis31DTextuelle Darstellung eines Tages; drei Buchstaben MonbisSunjTag des Monats; zwei Ziffern ohne vorangestellte Null 1bis31l(kleines 'L')Vollständige textuelle Darstellung eines Tages SundaybisSaturdayNNumerische Darstellung eines Wochentags gemäß ISO-8601 1(für Montag) bis7(für Sonntag)SEnglisches Ordnungssuffix für den Tag des Monats; zwei Buchstaben st,nd,rdoderth; funktioniert gut mitjwNumerische Darstellung eines Wochentags 0(für Sonntag) bis6(für Samstag)zTag des Jahres (beginnend bei 0) 0bis365Woche --- --- WWochennummer eines Jahres gemäß ISO-8601; die Wochen beginnen am Montag Beispiel: 42(die 42. Woche des Jahres)Monat --- --- FVollständige textuelle Darstellung eines Monats, z.B. January oder March JanuarybisDecembermNumerische Darstellung eines Monats; mit vorangestellter Null 01bis12MKurze textuelle Darstellung eines Monats; drei Buchstaben JanbisDecnNumerische Darstellung eines Monats; ohne vorangestellte Null 1bis12tAnzahl der Tage des angegebenen Monats 28bis31Jahr --- --- LGibt an, ob es ein Schaltjahr ist 1wenn es ein Schaltjahr ist, andernfalls0oJahreszahl gemäß ISO 8601-Wochennummer. Dies hat den gleichen Wert wie Y, außer wenn die ISO-Wochennummer (W) zum vorherigen oder nächsten Jahr gehört; dann wird stattdessen das Jahr dieser Woche verwendet.Beispiele: 1999oder2003XErweiterte vollständige numerische Darstellung einer Jahreszahl, mindestens 4-stellig, mit -für Jahre vor Christus und+für Jahre nach Christus.Beispiele: -0055,+0787,+1999,+10191xErweiterte vollständige numerische Darstellung einer Jahreszahl, falls erforderlich, oder standardmäßige vollständige numerische Darstellung, falls möglich (wie Y). Mindestens vier Ziffern. Jahren vor Christi Geburt wird ein-vorangestellt. Jahreszahlen über (und einschließlich)10000werden mit einem+eingeleitet.Beispiele: -0055,0787,1999,+10191YVollständige numerische Darstellung einer Jahreszahl; mindestens vier Ziffern, mit -für die Jahre vor ChristusBeispiele: -0055,0787,1999,2003,10191yDarstellung einer Jahreszahl; zwei Ziffern Beispiele: 99oder03Zeit --- --- aAnte meridiem und Post meridiem in Kleinbuchstaben amoderpmAAnte meridiem und Post meridiem in Großbuchstaben AModerPMBSwatch-Internetzeit 000bis999gStunde im 12-Stunden-Format; ohne vorangestellte Null 1bis12GStunde im 24-Stunden-Format; ohne vorangestellte Null 0bis23hStunde im 12-Stunden-Format; mit vorangestellter Null 01bis12HStunde im 24-Stunden-Format; mit vorangestellter Null 00bis23iMinuten; mit vorangestellter Null 00bis59sSekunden; mit vorangestellter Null 00bis59uMikrosekunden. Es ist zu beachten, dass die Funktion date() immer 000000ausgibt, weil sie einen Parameter vom Typ int erwartet, während DateTime::format() Mikrosekunden unterstützt, wenn DateTime mit Mikrosekunden erstellt wurde.Beispiel: 654321vMillisekunden. Es gilt der gleiche Hinweis wie für u.Beispiel: 654Zeitzone --- --- eBezeichner der Zeitzone Beispiele: UTC,GMT,Atlantic/AzoresI(großes i)Gibt an, ob das Datum in der Sommerzeit liegt oder nicht 1für Sommerzeit, andernfalls0ODifferenz zur Greenwich-Zeit (GMT); ohne Doppelpunkt zwischen Stunden und Minuten Beispiel: +0200PDifferenz zur Greenwich-Zeit (GMT); mit Doppelpunkt zwischen Stunden und Minuten Beispiel: +02:00pDasselbe wie P, gibt aberZzurück anstelle von+00:00(verfügbar seit PHP 8.0.0)Beispiel: +02:00TZeitzonenkürzel, falls bekannt; andernfalls die Abweichung von der GMT Beispiele: EST,MDT,+05ZZeitverschiebung in Sekunden. Der Wert ist für Zeitzonen westlich von der UTC immer negativ und für die Zeitzonen östlich von der UTC immer positiv. -43200bis50400Datum und Uhrzeit vollständig --- --- cDatum gemäß ISO 8601 2004-02-12T15:19:21+00:00 rDatum im Format » RFC 2822/» RFC 5322 Beispiel: Thu, 21 Dec 2000 16:01:07 +0200USekunden seit der Unix-Epoche (1. Januar 1970 00:00:00 GMT) Siehe auch time() In der Formatzeichenkette nicht erkannte Zeichen werden unverändert ausgegeben. In Verbindung mit der Funktion gmdate() gibt das Format
Zimmer0zurück.Hinweis:
Da diese Funktion nur Zeitstempel vom Typ int akzeptiert, ist das Formatzeichen
unur dann nützlich, wenn die Funktion date_format() mit benutzerdefinierten Zeitstempeln verwendet wird, die mit date_create() erstellt wurden.
Rückgabewerte
Gibt bei Erfolg eine Zeichenkette mit dem formatierten Datum zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 8.2.0 |
Die format-Zeichen X und
x wurden hinzugefügt.
|
| 8.0.0 |
Vor dieser Version wurde bei einem Fehler false zurückgegeben.
|
| 8.0.0 |
Das Formatzeichen p wurde hinzugefügt.
|
Beispiele
Beispiel #1 DateTime::format()-Beispiel
Objektorientierter Stil
<?php
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:s');
?>
Prozeduraler Stil
<?php
$date = date_create('2000-01-01');
echo date_format($date, 'Y-m-d H:i:s');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
2000-01-01 00:00:00
Anmerkungen
Diese Methode verwendet keine Gebietsschemata; die gesamte Ausgabe erfolgt auf englisch.
Siehe auch
- date() - Formatiert einen Unix-Zeitstempel

