# getdate

(PHP 4, PHP 5, PHP 7, PHP 8)

getdate — Retourne la date/heure

### Description

getdate(?int `$timestamp` = `null`): array

Retourne un array associatif contenant les informations de date et d'heure du `timestamp`, ou la date/heure courante locale si `timestamp` est omis ou `null`.

### Liste de paramètres

`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 tableau associatif contenant les informations de date et d'heure du timestamp `timestamp`. Les éléments du tableau associatif retourné sont les suivants :

Nom des clés du tableau associatif retourné
Clé | Description | Exemple de valeur retournée
--- | --- | ---
`"seconds"` | Représentation numérique des secondes | `0` à `59`
`"minutes"` | Représentation numérique des minutes | `0` à `59`
`"hours"` | Représentation numérique des heures | `0` à `23`
`"mday"` | Représentation numérique du jour du mois courant | `1` à `31`
`"wday"` | Représentation numérique du jour de la semaine courante | `0` (pour Dimanche) à `6` (pour Samedi)
`"mon"` | Représentation numérique du mois | `1` à `12`
`"year"` | Année, sur 4 chiffres | Exemples : `1999` ou `2003`
`"yday"` | Représentation numérique du jour de l'année | `0` à `365`
`"weekday"` | Version texte du jour de la semaine | `Sunday` à `Saturday`
`"month"` | Version texte du mois, comme `January` ou `March` | `January` à `December`
`0` | Nombre de secondes depuis l'époque Unix, similaire à la valeur retournée par la fonction time() et utilisée par date(). | Dépend du système, typiquement de `-2147483648` à `2147483647`.

### Historique

Version | Description
--- | ---
8.0.0 | `timestamp` est désormais nullable.

### Exemples

Exemple #1 Exemple avec getdate()

`<?php
$today = getdate();
print_r($today);
?>`

Résultat de l'exemple ci-dessus est similaire à :

    Array
    (
         [seconds] => 40
         [minutes] => 58
         [hours]   => 21
         [mday]    => 17
         [wday]    => 2
         [mon]     => 6
         [year]    => 2003
         [yday]    => 167
         [weekday] => Tuesday
         [month]   => June
         [0]       => 1055901520
    )

### Voir aussi

- date() - Formate un horodatage Unix
- idate() - Formate une partie de l'heure/date locale en tant qu'entier
- localtime() - Récupère l'heure locale
- time() - Retourne l'horodatage UNIX actuel
- setlocale() - Modifie les informations de localisation