(PHP 5 >= 5.2.0, PHP 7, PHP 8)
date_parse — Retourne un tableau associatif avec des informations détaillées sur une date/moment donnée
date_parse() analyse la chaîne datetime
donnée selon les mêmes règles strtotime() et DateTimeImmutable::__construct(). Au lieu de renvoyer un horodatage Unix (avec strtotime()) ou un objet DateTimeImmutable (avec DateTimeImmutable::__construct()), il renvoie un tableau associatif avec les informations qu'il pourrait détecter dans la chaîne datetime
donnée.
Si aucune information sur un certain groupe d'éléments ne peut être trouvée, ces éléments du tableau seront définis sur false
ou seront manquants. Si nécessaire pour construire un horodatage ou un objet DateTimeImmutable à partir de la même chaîne datetime
, plusieurs champs peuvent être définis sur une valeur non-false
. Voir les exemples ci-dessous pour les cas où cela se produit.
datetime
Date/moment dans un format accepté par DateTimeImmutable::__construct().
Retourne un tableau contenant des informations sur la date/moment analysée.
Le tableau retourné a des clés pour year
, month
, day
, hour
, minute
, second
, fraction
, et is_localtime
.
Si is_localtime
est présent, alors zone_type
indique le type de fuseau horaire. Pour le type 1
(décalage UTC) les champs zone
et is_dst
sont ajoutés. Pour le type 2
(abréviation) les champs tz_abbr
et is_dst
sont ajoutés. Pour le type 3
(identifiant de fuseau horaire) les champs tz_abbr
et tz_id
sont ajoutés.
Le tableau inclus les champs warning_count
et warnings
. Le premier indique le nombre d'avertissements. Les clés du tableau warnings
indiquent la position dans le paramètre datetime
où l'avertissement s'est produit, avec la valeur de chaîne décrivant l'avertissement lui-même. Un exemple ci-dessous montre un tel avertissement.
Le tableau inclus aussi les champs error_count
et errors
fields. Le premier indique le nombre d'erreurs. Les clés du tableau errors
indiquent la position dans le paramètre datetime
où l'erreur s'est produite, avec la valeur de chaîne décrivant l'avertissement lui-même. Un exemple ci-dessous montre un tel avertissement.
Le nombre d'éléments de tableau dans les tableaux warnings
et errors
peut être inférieur à warning_count
ou error_count
s'ils se sont produits à la même position.
Dans le cas où la fonction retourne une erreur, l'élément "errors"
contiendra les messages d'erreur.
Version | Description |
---|---|
7.2.0 | L'élément zone du tableau retourné représente maintenant des secondes au lieu des minutes, et son signe est inversé. Par exemple, -120 est maintenant 7200 . |
Exemple #1 date_parse() avec une chaîne datetime
complète
<?php
var_dump(date_parse("2006-12-12 10:00:00.5"));
?>
L'exemple ci-dessus va afficher :
array(12) { ["year"]=> int(2006) ["month"]=> int(12) ["day"]=> int(12) ["hour"]=> int(10) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0.5) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) }
Les éléments de fuseau horaire n'apparaissent que s'ils sont inclus dans la chaîne datetime
donnée. Dans ce cas, il y aura toujours un élément zone_type
et quelques autres en fonction de sa valeur.
Exemple #2 date_parse() avec des informations abrégé sur le fuseau horaire
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 BST"));
?>
L'exemple ci-dessus va afficher :
array(16) { ["year"]=> int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(10) ["minute"]=> int(28) ["second"]=> int(17) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(true) ["zone_type"]=> int(2) ["zone"]=> int(0) ["is_dst"]=> bool(true) ["tz_abbr"]=> string(3) "BST" }
Exemple #3 date_parse() avec des informations abrégé sur le fuseau horaire
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));
?>
L'exemple ci-dessus va afficher :
array(14) { ["year"]=> int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(10) ["minute"]=> int(28) ["second"]=> int(17) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(true) ["zone_type"]=> int(3) ["tz_id"]=> string(13) "Europe/London" }
Si une chaîne datetime
plus minimale est analysée, moins d'informations sont disponibles. Dans cet exemple, toutes les parties temporelles sont renvoyées comme false
.
Exemple #4 date_parse() avec une chaîne minimale
<?php
var_dump(date_parse("June 2nd, 2022"));
?>
L'exemple ci-dessus va afficher :
array(12) { ["year"]=> int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> bool(false) ["minute"]=> bool(false) ["second"]=> bool(false) ["fraction"]=> bool(false) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) }
Les formats relatifs n'influencent pas les valeurs analysées depuis des formats absoluts, mais sont analysées dans l'élément "relatif".
Exemple #5 Exemple avec date_parse() et des formats relatifs
<?php
var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>
L'exemple ci-dessus va afficher :
array(13) { ["year"]=> int(2006) ["month"]=> int(12) ["day"]=> int(12) ["hour"]=> int(10) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0.5) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) ["relative"]=> array(6) { ["year"]=> int(0) ["month"]=> int(0) ["day"]=> int(7) ["hour"]=> int(1) ["minute"]=> int(0) ["second"]=> int(0) } } )
Certaines strophes, telles que Thursday
(jeudi) définiront la partie heure de la chaîne sur 0
. Si Thursday
(jeudi) is est passé àDateTimeImmutable::__construct() l'heure, la minute, la seconde et la fraction seront également définies sur 0
. Dans l'exemple ci-dessous, l'élément année est cependant laissé à false
.
Exemple #6 date_parse() avec des effets secondaires
<?php
var_dump(date_parse("Thursday, June 2nd"));
?>
L'exemple ci-dessus va afficher :
array(13) { ["year"]=> bool(false) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(0) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) ["relative"]=> array(7) { ["year"]=> int(0) ["month"]=> int(0) ["day"]=> int(0) ["hour"]=> int(0) ["minute"]=> int(0) ["second"]=> int(0) ["weekday"]=> int(4) } }
datetime
avec un format spécifique