Formate une partie de l'heure/date locale en tant qu'entier

# idate

(PHP 5, PHP 7, PHP 8)

idate — Formate une partie de l'heure/date locale en tant qu'entier

### Description

function 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` | Nombre de jours dans le 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

- 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open