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