A warning to others. Some keys will return with a default value where others will return as false if the date string has it omitted. Unsure if this is a bug or feature, but hopefully this will save someone some time.
<?php
///Example
$input = "Feb 2010";
$info = date_parse($input);
var_dump($info);
/*Returns:
array(12) {
["year"]=> int(2010)
["month"]=> int(2)
["day"]=> int(1) //<---expected false like below
["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)
}*/
?>
date_parse
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
date_parse — Retorna um array associativo com informações detalhadas da data/hora informada
Descrição
A função date_parse() analisa a string
datetime informada conforme as mesmas regras de
strtotime() e
DateTimeImmutable::__construct(). Ao invés de retornar um
timestamp Unix (com strtotime()) ou
objeto DateTimeImmutable (com
a função DateTimeImmutable::__construct()), ela retorna um
array associativo com a informação que ela poderia detectar na
string datetime fornecida.
Se nenhuma informação sobre um certo grupo de elementos puder ser encontrada, estes
elementos do array serão configurados para false or omitidos. Se necessário para
construção de um timestamp ou objeto DateTimeImmutable a partir
da mesma string datetime, mais campos podem ser configurados para
um valor não-false. Veja os exemplos para casos onde isso acontece..
Valor Retornado
Retorna um array com informações da data/hora analisada.
O array de retorno tem chaves para year,
month, day, hour,
minute, second,
fraction, e is_localtime.
Se is_localtime estiver presente então
zone_type indica o tipo do fuso horário. Para o tipo
1 (deslocamento UTC), os campos zone e
is_dst são incluídos; para o tipo 2
(abreviação), os campos tz_abbr e
is_dst são incluídos; e para tipo 3
(identificador de fuso), os campos tz_abbr e
tz_id são incluídos.
Se elementos de tempo relativo estiverem presentes na
string datetime como +3 days,
então o array retornado incluirá um array aninhado com a chave
relative. Este array então conterá as chaves
year, month, day,
hour, minute,
second, e se necessário weekday e
weekdays, dependendo da string que foi passada.
O array inclui os campos warning_count e
warnings. O primeiro indica quantos
avisos ocorreram.
As chaves dos elementos do array warnings indicam as
posições na string datetime onde os avisos
ocorreram, com o valor da string descrevendo o aviso em si.
O array também contém os campos error_count e
errors. O primeiro indica quantos erros
foram encontrados.
As chaves dos elementos do array errors indicam
posição na string datetime onde os erros
ocorreram, com o valor da string descrevendo o erro em si.
Aviso
O número de elementos do arrays warnings ou
errors pode ser menor que
warning_count ou error_count se eles
ocorreram na mesma posição.
Erros/Exceções
Se o formato da data/hora contiver erro, o elemento 'errors' conterá as mensagens de erro.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 7.2.0 |
O elemento zone do array de retorno agora representa
segundos no lugar de minutos, e seu sinal é invertido. Por exemplo,
-120 é agora 7200.
|
Exemplos
Exemplo #1 Um exemplo da função date_parse()com um
string datetime compreensivo
<?php
var_dump(date_parse("2006-12-12 10:00:00.5"));
?>O exemplo acima produzirá:
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)
}
Os elementos de fuso horário só aparecem se eles forem incluídos no parâmetro
datetime. Neste caso sempre haverá
um elemento zone_type e alguns mais dependendo
do seu valor.
Exemplo #2 Exemplo da função date_parse() com informação de abreviação de fuso horário
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 BST"));
?>O exemplo acima produzirá:
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"
}
Exemplo #3 Exemplo da função date_parse() com informação de identificador de fuso horário
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));
?>O exemplo acima produzirá:
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"
}
Se uma string mais enxuta de datetime for analisada, menos
informação estará disponível. Neste exemplo, todas as partes de horário são retornadas
como false.
Exemplo #4 Função date_parse() com um string minimizado
<?php
var_dump(date_parse("June 2nd, 2022"));
?>O exemplo acima produzirá:
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)
}
Formatos relativos não influenciam valores interpretados de formatos absolutos, mas são analisados no elemento "relative".
Exemplo #5 date_parse() com formatos relativos
<?php
var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>O exemplo acima produzirá:
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)
}
}
Algumas estrofes, como Thursday irão configurar a parte de horário
da string para 0. Se Thursday for
passado para a função DateTimeImmutable::__construct(), ela também
teria resultado em hora, minuto, segundo e fração configurados para
0. No exemplo abaixo, o elemento do ano também
é configurado como false.
Exemplo #6 Função date_parse() com efeitos colaterais
<?php
var_dump(date_parse("Thursday, June 2nd"));
?>O exemplo acima produzirá:
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)
}
}
Veja Também
- date_parse_from_format() - Retorna informações sobre uma data informada de acordo com um formato para
analisar um
datetimecom um formato específico - checkdate() - Valida uma data gregoriana para validação da data do calendário gregoriano
- getdate() - Recupera informações de data/hora
add a note
User Contributed Notes 11 notes
admin at torntech dot com ¶
14 years ago
alvaro at demogracia dot com ¶
13 years ago
Be aware that date_parse() is happy with just a time zone and it can be pretty counter-intuitive. E.g.:
<?php
var_dump( date_parse('Europe/Madrid') );
?>
... prints an array where year, month, day... are FALSE. But so do these:
<?php
var_dump( date_parse('A') );
var_dump( date_parse('B') );
var_dump( date_parse('X') );
?>
Don't forget to further validate date_parse()'s output even when it isn't FALSE and the 'errors' key is empty.
thisismelennart dot borgman at gmail dot com ¶
10 years ago
Here is a workaround for the "Feb 2010" problem. It also handles "2014".
http://stackoverflow.com/questions/27052374/php-date-parsefeb-2010-gives-day-1/27068409
edg at greenberg dot org ¶
6 years ago
Passing "YYYY-MM" results in a valid date. Be careful to validate that your submitted date passed YOUR requirements.
paul at juniperwebcraft dot com ¶
7 years ago
It's sometimes useful to be able to store incomplete dates, for example when all you know of someone's birthdate is the year or the month and day.
date_parse() handles (and MySQL accepts) dates containing zero-value elements such as "2017-00-00" and "0000-03-29", leaving it up to the parent application to determine when to require and how to handle missing date elements. date_parse() correctly reports zero values for zero-value date elements, reports an 'invalid date' warning, and does not report an error.
Example 1: Year only
<?php print_r( date_parse( '2017-00-00' ) );?>
generates:
<?php
Array
(
[year] => 2017
[month] => 0
[day] => 0
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 1
[warnings] => Array
(
[11] => The parsed date was invalid
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
?>
Example 2: Month and day only
<?php print_r( date_parse( '0000-03-29' ) )?>
generates:
<?php
Array
(
[year] => 0
[month] => 3
[day] => 29
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 1
[warnings] => Array
(
[11] => The parsed date was invalid
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
?>
However, simply omitting date elements gives PHP too much discretion in second-guessing our intentions:
Example 3: Truncated date:
<?php print_r( date_parse( '2017-03' ) )?>
generates:
<?php
Array
(
[year] => 2017
[month] => 3
[day] => 1
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 0
[warnings] => Array
(
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)?>
In this case, PHP supplies a day value of 1 and does not report a warning.
Similarly, this feature of accepting zero date elements does not carry over to timestamps:
<?php $dDate = strtotime( '2017-03-00' );
print_r( getdate( $dDate ) ); ?>
displays:
<?php Array
(
[seconds] => 0
[minutes] => 0
[hours] => 0
[mday] => 28
[wday] => 2
[mon] => 2
[year] => 2017
[yday] => 58
[weekday] => Tuesday
[month] => February
[0] => 1488268800
)
?>
In this case, PHP interprets the "zeroth" day of March to be the last day of February.
y dot adounis at gmail dot com ¶
4 years ago
Developers, be aware that using "now" will return an empty array, ex :
<?php
date_parse("now");
?>
Will return :
Array
(
[year] =>
[month] =>
[day] =>
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 0
[warnings] => Array
(
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
ryan_a_martin at yahoo dot com ¶
13 years ago
See checkdate() at http://php.net/manual/en/function.checkdate.php for Gregorian date validation.
gpayne at galenaparkisd com ¶
17 years ago
Careful - date_parse is perfectly happy with something like this:
date_parse("2006-2-31");
adamm at extratech dot com ¶
12 years ago
A warning to some
<?php
$time = "00:14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will get what you expect
$time = "-00:14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will recieve hours minutes and seconds as booleans and as false and you will get error set to "Unexpected character"
$time = "00:-14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will recieve the same as the above
$time = "00:14:-38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will receive hours as 00 minutes as 14 and seconds as 0. The error will get set as the same as above. Meaning "Unexpected character"
?>
alan at wilcoxengineering dot com ¶
15 years ago
Caution: date_parse expects months 1..12 only.
date_parse("13/1/5769") for month=13, Ehul in Jewish calendar, results in month==3 instead of month==13.
It does, however, report the error array showing "Unexpected Character."
It would be nice if date_parse could handle the months properly (just report back a "13" for the month). The older approach of substr() is my workaround.
eugene at ultimatecms dot co dot za ¶
14 years ago
<?php
$ida = '091122671325';
$idb = '091123671325';
// This function will match the identity number up to the day, but only for a maximum of 99years+364days.
// Will not work when checking persons older than 100years-1day.
function idtodate($id)
{
$year = date("Y");
$month = date("m");
$day = date("d");
$nc = substr($year, 0, 2);
$ny = substr($year, 2, 2);
$y = substr($id, 0, 2);
$m = substr($id, 2, 2);
$d = substr($id, 4, 2);
if($y.$m.$d <= $ny.$month.$day-1) {
$newc = $nc;
} else {
$newc = $nc-1;
}
$new = $newc.$y;
return array('year' => $new, 'month' => $m, 'day' => $d);
}
echo 'ID: '.$ida.'<br>';
print_r(idtodate($ida));
echo '<br><br>';
echo 'ID: '.$idb.'<br>';
print_r(idtodate($idb));
?>
Output:
1. If the year-month-day is smaller than today (2009-11-23), but bigger than 1999: year => 2009
ID: 091122671325
Array ( [year] => 2009 [month] => 11 [day] => 22 )
2. If the year-month-day is the same as, or bigger than today, but smaller than 2000: year => 1909
ID: 091123671325
Array ( [year] => 1909 [month] => 11 [day] => 23 )
