# strptime

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

strptime — Analyse une date générée par strftime()

Avertissement

Cette fonction est OBSOLÈTE à partir de PHP 8.1.0. Dépendre de cette fonction est fortement déconseillé.

### Description

#[\Deprecated]
strptime(string `$timestamp`, string `$format`): array|false

strptime() retourne un tableau après avoir analysé `timestamp`, ou `false` en cas d'erreur.

Les noms des mois et jours de la semaine dépendent de la configuration locale, choisie avec setlocale() (`LC_TIME`).

### Liste de paramètres

`timestamp` (chaîne de caractères)

  La chaîne à analyser (e.g. retournée par strftime())

`format` (chaîne de caractères)

  Le format utilisé par `timestamp` (e.g. le même que celui qui a été utilisé par strftime()).

  Pour plus d'informations sur les spécificateurs de formats, voyez la fonction strftime().

### Valeurs de retour

Retourne un tableau ou `false` si une erreur survient.

Les paramètres suivants sont retournés dans le tableau
Paramètres | Description
--- | ---
`"tm_sec"` | Secondes après la minute (0-61)
`"tm_min"` | Minutes après l'heure (0-59)
`"tm_hour"` | Heure depuis minuit (0-23)
`"tm_mday"` | Jour du mois (1-31)
`"tm_mon"` | Mois depuis janvier (0-11)
`"tm_year"` | Années depuis 1900
`"tm_wday"` | Jours depuis dimanche (0-6)
`"tm_yday"` | Jours depuis le 1er janvier (0-365)
`"unparsed"` | La partie de `timestamp` qui n'a pas été reconnue par l'analyseur avec le `format` spécifié.

### Historique

Version | Description
--- | ---
8.1.0 | Cette fonction a été rendue obsolète. Utiliser date_parse_from_format() à la place (pour de l'analyse indépendant à la locale), ou IntlDateFormatter::parse() (pour de l'analyse dépendant à la locale)

### Exemples

Exemple #1 Exemple avec strptime()

`<?php
$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);
echo "$strf\n";
print_r(strptime($strf, $format));
?>`

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

    03/10/2004 15:54:19

    Array
    (
        [tm_sec] => 19
        [tm_min] => 54
        [tm_hour] => 15
        [tm_mday] => 3
        [tm_mon] => 9
        [tm_year] => 104
        [tm_wday] => 0
        [tm_yday] => 276
        [unparsed] =>
    )

### Notes

> Note: Cette fonction n'est pas implémentée sur les plates-formes Windows.

> Note:

> En interne, cette fonction appelle la fonction `strptime()` fournie par la bibliothèque système C. Cette fonction a des comportements bien différents suivants les systèmes d'exploitation. L'utilisation de la fonction date_parse_from_format(), qui elle, ne souffre pas de ces défauts, est recommandée.

> Note:

> `"tm_sec"` inclut toutes les secondes intercalaires (actuellement 2 par an). Pour plus d'informations sur les secondes intercalaires, reportez-vous à l'» article sur Wikipedia les concernant.

### Voir aussi

- IntlDateFormatter::parse() - Analyse une chaîne vers un timestamp
- DateTime::createFromFormat() - Analyse une heure au format texte selon le format spécifié.
- checkdate() - Valide une date grégorienne
- strftime() - Formate une date/heure locale avec la configuration locale
- date_parse_from_format() - Récupère les informations d'une date donnée suivant un format spécifique