strptime

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

strptime Analiza una fecha/hora generada con strftime()

Descripción

strptime(string $date, string $format): array

strptime() devuelve una matriz con la fecha date analizada, o false si se produjo un error.

Los nombres del mes y del día de la semana y otras cadenas dependientes del lenguaje están subordinados a la configuración regional local establecida con setlocale() (LC_TIME).

Parámetros

date (string)

La cadena a analizar (p.ej. devuelta por strftime()).

format (string)

El formato usado en date (p.ej. el mismo que el usado en strftime()). Observe que algunas de las opciones de formato disponibles en strftime() pueden no tener ningún efecto en strptime(); el subconjunto exacto que está soportado variará según el sistema operativo y a la biblioteca de C que esté en uso.

Para más información sobre las opciones de formato, lea la página de strftime().

Valores devueltos

Devuelve una matriz o false en caso de error.

Los siguietens parámetros son devueltos en la matriz
parámetros Descripción
"tm_sec" Segundos después del minuto (0-61)
"tm_min" Minutos después de la hora (0-59)
"tm_hour" Hora desde la medianoche (0-23)
"tm_mday" Día del mes (1-31)
"tm_mon" Meses desde Enero (0-11)
"tm_year" Años desde 1900
"tm_wday" Días desde el Domingo (0-6)
"tm_yday" Días desde el 1 de Enero (0-365)
"unparsed" la parte de date que no fue reconocida usando el formato format especificado

Ejemplos

Ejemplo #1 Ejemplo de strptime()

<?php
$formato 
'%d/%m/%Y %H:%M:%S';
$strf strftime($formato);

echo 
"$strf\n";

print_r(strptime($strf$formato));
?>

El resultado del ejemplo sería algo similar 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

Nota: Esta función no está implementada en plataformas Windows.

Nota:

Internamente, esta función llama a la función strptime() proporcionada por la biblioteca C del sistema. Esta función puede presentar diferencias notables de comportamiento en diferentes sistemas operativos. Se recomienda el uso de date_parse_from_format(), a la cuál no le afectan estas cosas, en PHP 5.3.0 y posterior.

Nota:

"tm_sec" incluye segundos intercalares (actualmente hasta 2 por año). Para más información acerca de los segundos intercalares, vea el » artículo de Wikipedia sobre segundos intercalares.

Nota:

Antes de PHP 5.2.0, esta función podía devolver un comportamiento indefinido. En particular, las entradas "tm_sec", "tm_min" y "tm_hour" devolverían valores indefinidos.

Ver también