array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.idate.php', 1 => 'idate', 2 => 'Formate une partie de l\'heure/date locale en tant qu\'entier', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Fonctions Date/Heure', ), 'prev' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', ), 'next' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', '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 — Formate une partie de l'heure/date locale en tant qu'entier

Description

idate(string $format, ?int $timestamp = null): int|false

idate() retourne un nombre formaté avec le format format et représentant le timestamp timestamp ou l'heure courante si timestamp est omis. En d'autres termes, le paramètre timestamp est optionnel et la valeur par défaut est la valeur retournée par la fonction time().

À l'inverse de la fonction date(), idate() accepte juste un caractère comme paramètre format.

Liste de paramètres

format

Les caractères suivants sont reconnus dans la chaîne de caractères du paramètre format
Caractères de format Description
B Temps Internet Swatch Beat
d Le jour du mois
h Heure (format 12 heures)
H Heure (format 24 heures)
i Minutes
I(i, en majuscule) Retourne 1 si l'heure d'été est activée, 0 sinon
L(l, en majuscule) Retourne 1 pour une année bissextile, 0 sinon
m Numéro du mois
N Jour de la semaine ISO-8601 (1 pour le lundi à 7 pour le dimanche)
o Année ISO-8601 (4 chiffres)
s Secondes
t Jour du mois courant
U Secondes depuis l'époque Unix - 1 Janvier 1970 00:00:00 UTC - c'est la même chose que la fonction time()
w Jour de la semaine (0 pour Dimanche)
W Le numéro de semaine de l'année ; selon l'ISO-8601, les semaines débutent le Lundi
y Année sur 1 ou 2 chiffres, voir la note plus bas
Y Année sur 4 chiffres
z Jour de l'année
Z Décalage horaire, en secondes

timestamp

Le paramètre optionnel timestamp est un timestamp Unix de type entier qui vaut par défaut l'heure courante locale si timestamp est omis ou null. En d'autres termes, il vaut par défaut la valeur de la fonction time().

Valeurs de retour

Retourne un int en cas de succès, ou false si une erreur survient.

Sachant que idate() retourne toujours un entier et qu'il ne peut commencer par 0, idate() peut retourner moins de chiffres que ce dont on pourrait espérer. Voir l'exemple ci-dessous.

Erreurs / Exceptions

Chaque appel à une fonction date/heure générera un diagnostic de type E_WARNING si le fuseau horaire n'est pas valide. Voir aussi date_default_timezone_set()

Historique

Version Description
8.2.0 Ajoute les caractères de format N (jour de la semaine ISO-8601) et o (année ISO-8601).
8.0.0 timestamp est désormais nullable.

Exemples

Exemple #1 Exemple avec idate()

<?php
$timestamp = strtotime('1st January 2004'); // 1072915200

// ceci affiche l'année sur deux chiffres
// néanmoins, vu que ce chiffre va commencer par "0",
// seul "4" sera affiché
echo idate('y', $timestamp) . "\n";

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

L'exemple ci-dessus va afficher :

4
24

Voir aussi