(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
strptime(string
$timestamp
, string
$format
): array|false
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
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