(PHP 4, PHP 5, PHP 7, PHP 8)
strtotime — Transforma un texto inglés en timestamp
La función strtotime() intenta leer una
fecha en formato inglés proporcionada por el parámetro time
,
y transformarla en un timestamp Unix (el número de segundos desde
el 1 de enero de 1970 a 00:00:00 UTC), relativo al timestamp
baseTimestamp
, o a la fecha actual si este último
es omitido. El análisis de la cadena de fecha está definido en
los formatos de fecha y hora
y presenta varias consideraciones sutiles. Se recomienda encarecidamente
examinar todos los detalles.
El timestamp Unix que devuelve esta función no contiene información sobre los husos horarios. Para realizar cálculos con información de fecha/hora, es preferible utilizar DateTimeImmutable que es más capaz.
Cada parámetro de la función utiliza el desplazamiento horario por defecto a menos que se especifique explícitamente un desplazamiento horario. Tenga cuidado de no utilizar un desplazamiento horario diferente para cada parámetro a menos que sea lo que se necesita. Consulte la función date_default_timezone_get() para saber cómo definir un desplazamiento horario por defecto.
datetime
Una cadena de fecha/hora. Los formatos válidos se explican en Formatos de fecha y hora.
baseTimestamp
El timestamp, que representa la fecha actual, utilizado para el cálculo relativo de fechas.
Devuelve un timestamp en caso de éxito, false
en caso contrario.
Cada vez que se llame a una función de fecha/hora se generará un E_NOTICE
si la zona horaria no es válida, y/o un mensaje E_STRICT
o E_WARNING
si se emplea la configuración del sistema o la variable global
TZ. Véase también date_default_timezone_set()
Versión | Descripción |
---|---|
8.0.0 |
baseTimestamp ahora es nullable.
|
Ejemplo #1 Ejemplo con strtotime()
<?php
echo strtotime("now"), "\n";
echo strtotime("10 September 2000"), "\n";
echo strtotime("+1 day"), "\n";
echo strtotime("+1 week"), "\n";
echo strtotime("+1 week 2 days 4 hours 2 seconds"), "\n";
echo strtotime("next Thursday"), "\n";
echo strtotime("last Monday"), "\n";
?>
Ejemplo #2 Verificación de error
<?php
$str = 'No es válido';
if (($timestamp = strtotime($str)) === false) {
echo "La cadena ($str) está corrupta";
} else {
echo "$str == " . date('l dS \o\f F Y h:i:s A', $timestamp);
}
?>
Nota:
En este caso, la fecha "relativa" significa también que si un componente particular del timestamp no es proporcionado, será extraído textualmente de
baseTimestamp
. En otras palabras,strtotime('February')
, si se ejecuta el 31 de mayo de 2022, será interpretado como el31 de febrero de 2022
, lo que desbordará a un timestamp el3 de marzo
. (En un año bisiesto, sería el2 de marzo
.) El uso destrtotime('1 February')
ostrtotime('first day of February')
evitaría este problema.
Nota:
Si el número de años se especifica en dos dígitos, los valores entre 00-69 corresponden a 2000-2069 y 70-99 a 1970-1999. Consulte las notas posteriores sobre las posibles diferencias entre sistemas de 32 bits (las fechas pueden fallar después del 19/01/2038 a 03:14:07).
Nota:
El intervalo de validez de un timestamp va del Viernes 13 de diciembre de 1901 20:45:54 UTC al Martes 19 de enero de 2038 03:14:07 UTC. (Esto corresponde a las fechas máximas y mínimas para un entero de 32 bits firmado).
Para las versiones de 64 bits de PHP, el intervalo válido de un timestamp es realmente infinito, sabiendo que 64 bits puede representar aproximadamente 293 mil millones de años en cualquier dirección.
Nota:
El uso de esta función en operaciones matemáticas no está recomendado. Es preferible utilizar en este caso DateTime::add() y DateTime::sub().