# 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

- checkdate() - Validar una fecha gregoriana
- strftime() - Formatea una fecha/hora local según una configuración local
- date_parse_from_format() - Obtiene información de una fecha dada formateada de acuerdo al formato especificado
- DateTime::createFromFormat() - Analiza una cadena con un instante según un formato especificado