array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.idate.php', 1 => 'idate', 2 => 'Formatiert einen Teil der lokalen Zeit/des lokalen Datums als Integer', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Datum/Uhrzeit-Funktionen', ), 'prev' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', ), 'next' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/datetime/functions/idate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

idate

(PHP 5, PHP 7, PHP 8)

idate — Formatiert einen Teil der lokalen Zeit/des lokalen Datums als Integer

Beschreibung

idate(string $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 format erkannt
format-Zeichen Beschreibung
B Swatch-Internetzeit (Swatch-Beat)
d Tag des Monats
h Stunde (12-Stunden-Format)
H Stunde (24-Stunden-Format)
i Minuten
I (großes i) Gibt 1 zurück, wenn die Sommerzeit aktiviert ist, andernfalls 0
L (großes l) Gibt bei einem Schaltjahr 1 zurück, andernfalls 0
m Nummer des Monats
N ISO-8601-Wochentag (1 für Montag bis 7 für Sonntag)
o ISO-8601-Jahr (4 Ziffern)
s Sekunden
t Anzahl der Tage im aktuellen Monat
U Anzahl der Sekunden seit der Unix-Epoche - 1. Januar 1970 00:00:00 UTC - dies ist gleichbedeutend mit time()
w Wochentag (0 für Sonntag)
W ISO-8601-Wochennummer des Jahres, Wochen beginnend am Montag
y Jahr (1 oder 2 Ziffern - siehe Hinweis unten)
Y Jahr (4 Ziffern)
z Tag des Jahres
Z Zeitverschiebung in Sekunden

timestamp

Der optionale Parameter timestamp ist ein Unix-Zeitstempel vom Typ int. Falls timestamp nicht übergeben wird oder null ist, wird die aktuelle lokale Zeit als Standardwert verwendet. 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

Wenn die Zeitzone ungültig ist, wird bei jedem Aufruf einer Datums/Zeit-Funktion ein Fehler der Stufe E_WARNING erzeugt. 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) . "\n";

$timestamp = strtotime('1st January 2024'); // 1704067200
echo idate('y', $timestamp);

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

4
24

Siehe auch