$date
, string $format
) : array
strptime() retorna um array com a interpretação de
date , 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).
date (string)A string a ser interpretada (retornada da função strftime()).
format (string)
O formato utilizado em date (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 Sunday (0-6) |
| "tm_yday" | Dias passados desde January 1 (0-365) |
| "unparsed" | A parte date que não foi
reconhecida usando o format especificado |
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 irá imprimir algo similar à:
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 é implementada na plataforma 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 em versões do PHP 5.3.0 e superiores.
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.
Nota:
Em versões anteriores ao PHP 5.2.0, a função poderia ter um comportamento inesperado. Excepcionalmente, as entradas "tm_sec", "tm_min" e "tm_hour" poderiam ser retornadas como valores indefinidos.