idate

(PHP 5)

idate -- Formate une date/heure locale en tant qu'entier

Description

int idate ( string format [, int timestamp] )

idate() retourne une nombre formaté avec le format format et représentant le timestamp timestamp ou l'heure courant 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

Tableau 1. Les caractères suivants sont reconnus dans la chaîne de caractères du paramètre format

Caractères de formatDescription
BTemps Internet Swatch Beat
dLe jour du mois
hHeure (format 12 heures)
HHeure (format 24 heures)
iMinutes
IRetourne 1 si l'heure d'été est activée, 0 sinon
LRetourne 1 pour une année bissextile, 0 sinon
mNuméro du mois
sSecondes
tJour du mois courant
USecondes depuis l'époque Unix - 1 Janvier 1970 00:00:00 GMT - c'est la même chose que la fonction time()
wJour de la semaine (0 pour Dimanche)
WLe numéro de semaine de l'année ; selon l'ISO-8601, les semaines débutent le Lundi
yAnnée sur 1 ou 2 chiffres, voir la note plus bas
YAnnée sur 4 chiffres
zJour de l'année
ZDé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 le paramètre timestamp n'est pas fourni. En d'autres termes, il faut par défaut la valeur de la fonction time().

Valeurs de retour

Retourne un entier.

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 message de type E_NOTICE si le fuseau horaire n'est pas valide., et/ou un message de type E_STRICT si vous utilisez la configuration du système ou la variable d'environnement TZ. Voir aussi date_default_timezone_set()

Historique

VersionDescription
5.1.0

Émet un message de type E_STRICT et E_NOTICE lors d'erreurs de fuseaux horaires.

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);
?>

Voir aussi

date()
time()