strptime

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

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

Warning

Esta função tornou-se DEFASADA a partir do PHP 8.1.0. O uso desta função é fortemente desencorajado.

Descrição

strptime(string $timestamp, string $format): array|false

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

Parâmetros

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

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

Registro de Alterações

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

Exemplos

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

Notas

Note: Esta função não foi implementada em plataformas Windows.

Note:

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.

Note:

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

Veja Também