(PHP 5 >= 5.1.0, PHP 7, PHP 8)
strptime — Interpreta uma hora/data gerada pela função strftime()
Esta função tornou-se DEFASADA a partir do PHP 8.1.0. O uso desta função é fortemente desencorajado.
strptime() retorna um array com a
timestamp
analisada, ou false
em caso de erro.
Nomes de meses e semanas, e outras strings que dependem do idioma, respeitam o
idioma corrente definido com a função setlocale() (LC_TIME
).
timestamp
(string)A string a ser interpretada (retornada da função strftime()).
format
(string)
O formato utilizado em timestamp
(o mesmo utilizado
na função strftime()). Note que algumas opções de
formato disponíveis na função strftime() podem não ter nenhum
efeito com strptime(); o subconjunto exato que é
suportado vai variar por ser baseado no sistema operacional e biblioteca C em
uso.
Para mais informações sobre as opções de formato, veja a página da função strftime().
Retorna um array ou false
em caso de falha.
Parâmetro | Descrição |
---|---|
"tm_sec" |
Segundos após o minuto (0-61) |
"tm_min" |
Minutos após a hora (0-59) |
"tm_hour" |
Horas passadas desde a meia-noite (0-23) |
"tm_mday" |
Dia do mês (1-31) |
"tm_mon" |
Meses passados desde janeiro (0-11) |
"tm_year" |
Anos passados desde 1900 |
"tm_wday" |
Dias passados desde domingo (0-6) |
"tm_yday" |
Dias passados desde 1º de janeiro 1 (0-365) |
"unparsed" |
A parte timestamp que não foi
reconhecida usando o format especificado |
Versão | Descrição |
---|---|
8.1.0 | Esta função foi descontinuada. Use date_parse_from_format() no lugar (para análise independente de localidade), ou IntlDateFormatter::parse() (para análise dependente de localidade). |
Exemplo #1 Exemplo da função strptime()
<?php
$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);
echo "$strf\n";
print_r(strptime($strf, $format));
?>
O exemplo acima produzirá algo semelhante a:
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] => )
Nota: Esta função não foi implementada em plataformas Windows.
Nota:
Internamente, esta função chama a função
strptime()
presente na biblioteca C do sistema. Esta função pode apresentar um comportamento diferente entre diferentes sistemas operacionais. A utilização da função date_parse_from_format(), que não é afetada por esta questão, é recomendada.
Nota:
"tm_sec"
inclui todos os segundos do ano bissexto (atualmente 2 por ano). Para mais informações sobre segundos do ano bissexto, veja o » o artigo da Wikipedia sobre segundos Bissexto.