idate
(PHP 5, PHP 7, PHP 8)
idate — Formate une date/heure locale en tant qu'entier
Description
idate(string $format
, int|null $timestamp
= null
): int|false
À 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 |
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 message de type
E_NOTICE
si le fuseau horaire n'est pas valide,
et/ou un message de type E_STRICT
ou E_WARNING
si vous
utilisez la configuration du système ou la variable d'environnement
TZ. Voir aussi date_default_timezone_set()
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() - Formate une date/heure locale
- getdate() - Retourne la date/heure
- time() - Retourne le timestamp UNIX actuel