idate
(PHP 5, PHP 7, PHP 8)
idate — Formatiert ein lokales Datum/eine lokale Uhrzeit als Integer
Beschreibung
$format, ?int $timestamp = null): int|false
Formatiert den angegebenen ganzzahligen Zeitstempel
timestamp entsprechend dem angegebenen Formatzeichen
und gibt eine Datumszahl zurück. Wenn kein Zeitstempel angegeben wird, wird
die aktuelle Ortszeit verwendet. Mit anderen Worten:
timestamp ist optional und wird mit dem Wert der
Funktion time() vorbelegt.
Anders als die Funktion date() akzeptiert
idate() nur ein Zeichen im Parameter
format.
Parameter-Liste
-
format -
Die folgenden Zeichen werden in der Parameterzeichenkette formaterkanntformat-ZeichenBeschreibung BSwatch-Internetzeit (Swatch-Beat) dTag des Monats hStunde (12-Stunden-Format) HStunde (24-Stunden-Format) iMinuten I(großes i)Gibt 1zurück, wenn die Sommerzeit aktiviert ist, andernfalls0L(großes l)Gibt bei einem Schaltjahr 1zurück, andernfalls0mNummer des Monats NISO-8601-Wochentag ( 1für Montag bis7für Sonntag)oISO-8601-Jahr (4 Ziffern) sSekunden tAnzahl der Tage im aktuellen Monat UAnzahl der Sekunden seit der Unix-Epoche - 1. Januar 1970 00:00:00 UTC - dies ist gleichbedeutend mit time() wWochentag ( 0für Sonntag)WISO-8601-Wochennummer des Jahres, Wochen beginnend am Montag yJahr (1 oder 2 Ziffern - siehe Hinweis unten) YJahr (4 Ziffern) zTag des Jahres ZZeitverschiebung in Sekunden -
timestamp -
Der optionale Parameter
timestampist ein Unix-Timestamp als int oder die aktuelle lokale Zeit, wenntimestampnicht übergeben wurde odernullist. Er entspricht dann also dem Ergebnis der Funktion time().
Rückgabewerte
Gibt bei Erfolg einen Wert vom Typ int zurück.
Bei einem Fehler wird false zurückgegeben.
Da idate() immer einen Wert vom Typ int zurückgibt und dieser nicht mit einer "0" beginnen kann, gibt idate() möglicherweise weniger Ziffern zurück, als zu erwarten wäre. Siehe das Beispiel unten.
Fehler/Exceptions
Jeder Aufruf der Datums- und Zeitfunktionen generiert einen Fehler der Stufe
E_WARNING, wenn die Zeitzone ungültig ist. Siehe auch
date_default_timezone_set()
Changelog
| Version | Beschreibung |
|---|---|
| 8.2.0 |
Die Zeichen N (ISO-8601-Wochentag) und
o (ISO-8601-Jahr) wurden hinzugefügt.
|
| 8.0.0 |
timestamp ist nun nullable (akzeptiert den
null-Wert).
|
Beispiele
Beispiel #1 idate()-Beispiel
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// dies gibt die Jahreszahl in einem zweistelligen Format aus
// da diese jedoch mit einer "0" beginnen würde, wird
// nur "4" ausgegeben.
echo idate('y', $timestamp);
?>
