Retourne un tableau associatif avec des informations détaillées sur une date/moment donnée

# date_parse

(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

### Description

function date_parse(string `$datetime`): array

date_parse() analyse la chaîne `datetime` donnée selon les mêmes règles que 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.

### Liste de paramètres

`datetime`

  Date/moment dans un format accepté par DateTimeImmutable::__construct().

### Valeurs de retour

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.

Si des éléments de temps relatifs sont présents dans la chaîne `datetime`, tels que `+3 days`, le tableau retourné inclut un tableau imbriqué avec la clé `relative`. Ce tableau contient alors les clés `year`, `month`, `day`, `hour`, `minute`, `second`, et si nécessaire `weekday`, et `weekdays`, selon la chaîne qui a été passée.

Le tableau inclut 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 inclut aussi les champs `error_count` et `errors`. 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.

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.

### Erreurs / Exceptions

Dans le cas où la fonction retourne une erreur, l'élément `"errors"` contiendra les messages d'erreur.

### Historique

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`.

### Exemples

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ées 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 d'identifiant de 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 absolus, mais sont analysés dans l'élément "relative".

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) 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)
      }
    }

### Voir aussi

- date_parse_from_format() - Récupère les informations d'une date donnée suivant un format spécifique pour analyser le paramètre `datetime` avec un format spécifique
- checkdate() - Valide une date grégorienne pour une validation de date Grégorienne
- getdate() - Retourne la date/heure

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open