Manuel PHP
Précédent |  | Suivant

# 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 `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` | Retourne `1` si l'heure d'été est activée, `0` sinon
  `L` | 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 GMT - 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 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

Version | Description
--- | ---
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()

Précédent | Sommaire | Suivant
gmstrftime | Niveau supérieur | localtime