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

### Voir aussi

- DateTimeInterface::format() - Retourne une date formatée suivant le format fourni
- date() - Formate un horodatage Unix
- getdate() - Retourne la date/heure
- time() - Retourne l'horodatage UNIX actuel