Funções de Data/Hora
PHP Manual

strptime

(PHP 5 >= 5.1.0, PHP 7)

strptime Interpreta uma hora/data gerada pela função strftime()

Descrição

array strptime ( string $date , string $format )

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

Parâmetros

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

Valor Retornado

Retorna um array ou FALSE em caso de falha.

Os seguintes parâmetros são retornados no array
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

Exemplos

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] =>
)

Notas

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.

Veja Também


Funções de Data/Hora
PHP Manual