Le mois de la fonction PHP : décomposer une date

This document is also available in English  

   

 Qui n'a jamais farfouillé du explode(), list(), et autres joyeuseries, afin de récupérer une date en bonne et dûe forme ?
 Ce temps est révolu, grace à date_parse()


date_parse() retourne un tableau préformaté de la date passée en paramètre.


Exemple 1 - Récupérer des infos sur la date

<?php
var_export(date_parse("03/01/2007 12:14"));
/* sortie :
array ( 'year' => 2007,
     'month' => 3,
     'day' => 1,
     'hour' => 12,
     'minute' => 14,
     'second' => 0,
     'fraction' => 0,
     'warning_count' => 0,
     'warnings' => array ( ),
     'error_count' => 0,
     'errors' => array ( ),
     'is_localtime' => false,
   )*/
?>

Exemple 2 - date_parse() fait des efforts pour comprendre

<?php
var_export(date_parse("03/01/2007 12:14"));
var_export(date_parse("2007/03/01 12:14"));
var_export(date_parse("12:14 2007/03/01"));
var_export(date_parse("12:14:00.001 2007/03/01"));
var_export(date_parse("12.14.00.001 2007-03-01"));
?>

Exemple 3 - date_parse() signale les erreurs dans une entree adaptée

<?php
print_r(date_parse("10:99:00.5 12-12-106"));
/*
Array
(
    [year] => 106
    [month] => 12
    [day] => 12
    [hour] => 10
    [minute] => 9
    [second] => 0
    [fraction] => 0
    [warning_count] => 0
    [warnings] => Array
        (
        )
 
    [error_count] => 1
    [errors] => Array
        (
            [4] => Double time specification
        )
 
    [is_localtime] => 
)
*/
?>

A noter

• date_parse() n'est disponible qu'à partir de PHP 5.2.
• date_parse() accepte les valeurs d'années de 100 à 9999 : en dessous de 100, on retourne à l'an 2000
• date_parse()traite directement les formats de dates de MySQL
• date_parse() peut aussi gérer les fuseaux horaires