Función PHP strtotime: Comprensión del análisis de fechas y horas

En la programación PHP, trabajar con fechas y horas es una tarea común que puede resultar complicada debido a la variedad de formatos y zonas horarias utilizados en diferentes sistemas y aplicaciones. La función strtotime es una herramienta poderosa que puede ayudar a los desarrolladores a analizar y manipular cadenas de fecha y hora con facilidad, pero también requiere un buen entendimiento de su sintaxis y opciones para evitar errores y resultados inesperados. En este artículo, exploraremos la función strtotime y su uso en detalle, proporcionando ejemplos y consejos que pueden ayudarte a mejorar tus habilidades de programación PHP.

¿Qué es la función strtotime?

La función strtotime es una función PHP incorporada que convierte una representación en string de una fecha y/o hora en un timestamp Unix, que es un valor numérico que representa el número de segundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC (Tiempo Universal Coordinado). El timestamp Unix es un formato ampliamente utilizado para almacenar y manipular fechas y horas en muchos lenguajes de programación y sistemas, y permite la fácil comparación, cálculo y formateo de fechas y horas.

La sintaxis de la función strtotime es la siguiente:

La sintaxis de la función strtotime()

<?php

strtotime ( string $time [, int $now = time() ] ) : int|false

donde $time es la cadena de entrada que contiene la fecha y/o la hora a analizar, y $now es un parámetro opcional que especifica el timestamp de referencia utilizado para los cálculos relativos. La función devuelve un timestamp Unix si la cadena de entrada es válida, o false si la cadena no se puede analizar.

Dado que el valor de retorno es solo un número de segundos, casi siempre se combina strtotime() con date() para convertirlo de nuevo en algo legible por humanos:

<?php

date_default_timezone_set('UTC');

$timestamp = strtotime("2023-03-03");
echo $timestamp;                                  // 1677801600
echo date("Y-m-d H:i:s", $timestamp);             // 2023-03-03 00:00:00

¿Cómo usar la función strtotime?

La función strtotime admite una amplia variedad de formatos de entrada y modificadores que se pueden combinar para analizar diversas expresiones de fecha y hora. Algunos de los formatos y modificadores más comunes son:

• Formatos de fecha: YYYY-MM-DD, MM/DD/YYYY, DD-MM-YYYY, YYYY.MM.DD, etc.
• Formatos de hora: HH:MM:SS, HH:MM, H:M:S AM/PM, HH:MM:SS +/-HHMM, etc.
• Desplazamientos de zona horaria: +HHMM, -HHMM, Z, etc.
• Expresiones relativas: now, yesterday, today, tomorrow, last/next day/week/month/year, +/- N days/weeks/months/years, first/last day/weekday/week/month/year of month/year, etc.

Para usar la función strtotime, debes pasar una cadena que contenga uno o más de estos formatos y modificadores, y la función intentará interpretarlos y convertirlos en un timestamp Unix. Aquí hay algunos ejemplos:

¿Cómo usar la función strtotime?

Como puedes ver, la función strtotime puede manejar varios formatos de entrada y expresiones relativas, pero es importante tener en cuenta que el comportamiento de la función puede variar según la zona horaria del sistema, la versión de PHP y la sintaxis y el contexto de la cadena de entrada. Por lo tanto, se recomienda usar la función strtotime con precaución y siempre probar y validar el resultado antes de usarlo en código de producción.

Aritmética de fechas relativas

Una de las características más útiles de strtotime() es el análisis de expresiones relativas sobre un timestamp base. Esto hace que preguntas como "¿cuál es la fecha dentro de una semana?" o "el primer día del próximo mes" sean triviales:

<?php

date_default_timezone_set('UTC');

$base = strtotime("2023-03-03");

echo date("Y-m-d", strtotime("+1 week", $base));                  // 2023-03-10
echo date("Y-m-d", strtotime("first day of next month", $base));  // 2023-04-01

Manejo del valor de retorno false

strtotime() devuelve false (no una excepción) cuando no puede entender la entrada. Ten en cuenta que false es igual de forma flexible a 0, por lo que siempre debes comprobarlo con el operador estricto ===; de lo contrario, un análisis fallido puede confundirse con el epoch (1 de enero de 1970):

<?php

$timestamp = strtotime("not a real date");

var_dump($timestamp);             // bool(false)

if ($timestamp === false) {
    echo "Could not parse the date.";
} else {
    echo date("Y-m-d", $timestamp);
}

Consejos y buenas prácticas

A continuación, se presentan algunos consejos y buenas prácticas a seguir al usar la función strtotime en tu código PHP:

1. Siempre sanear y validar la entrada del usuario: dado que la función strtotime acepta la entrada del usuario como una cadena, es importante asegurarse de que la entrada sea limpia y segura de usar. Puedes usar funciones como trim, strip_tags, htmlspecialchars y expresiones regulares para filtrar caracteres no deseados y prevenir ataques de inyección.
2. Usar formatos y zonas horarias explícitos: para evitar ambigüedades y errores, se recomienda usar formatos de fecha y hora explícitos, como ISO 8601, y especificar la zona horaria de forma explícita, ya sea como una cadena o como un objeto DateTimeZone. Esto se puede lograr usando funciones como date, gmdate, DateTime, DateTimeImmutable y DateTimeZone.
3. Probar y depurar tu código: para asegurarte de que tu función strtotime funcione como se pretende, debes probarla con varias cadenas de entrada, casos límite y escenarios, y verificar el resultado con tus expectativas. Puedes usar herramientas como var_dump, print_r y assert para depurar tu código y detectar errores.
4. Considerar el uso de bibliotecas alternativas de fecha y hora: aunque la función strtotime es una herramienta conveniente y poderosa, tiene algunas limitaciones y peculiaridades que pueden causar problemas en ciertas situaciones. Por lo tanto, puede ser conveniente considerar el uso de bibliotecas alternativas de fecha y hora, como Carbon o Chronos, que ofrecen más características y flexibilidad.

Nota sobre PHP moderno: Para proyectos nuevos, las clases DateTime y DateTimeImmutable son muy recomendables sobre strtotime debido a su mayor fiabilidad, diseño orientado a objetos y manejo explícito de zonas horarias. Usa strtotime principalmente para código heredado o análisis simple de fechas relativas. Consulta date_create y date_modify para los equivalentes orientados a objetos.

Funciones relacionadas

• date — formatea un timestamp Unix en una cadena legible.
• mktime — construye un timestamp a partir de partes de fecha individuales en lugar de una cadena.
• time — devuelve el timestamp Unix actual.
• date_create — la forma moderna y orientada a objetos de analizar fechas.
• PHP Fecha y Hora — descripción general del conjunto de herramientas de fecha/hora de PHP.

Conclusión

En este artículo, hemos explorado la función strtotime en PHP y su uso en el análisis y la manipulación de cadenas de fecha y hora. Hemos visto cómo funciona la función, qué formatos y modificadores admite, y qué consejos y buenas prácticas seguir al usarla en tu código. Al aplicar estos principios, puedes mejorar tus habilidades de programación PHP y escribir código de manejo de fechas más fiable. Recuerda siempre validar y sanear la entrada del usuario, usar formatos y zonas horarias explícitos, probar y depurar tu código, y considerar el uso de bibliotecas alternativas si es necesario. ¡Feliz programación!

graph TD;
A[strtotime Function] --> B[Unix timestamp];
B --> C[Date comparison];
B --> D[Date calculation];
B --> E[Date formatting];
C --> F[Equal to];
C --> G[Greater than];
C --> H[Less than];
D --> I[Addition];
D --> J[Subtraction];
E --> K[Textual representation];
E --> L[Numeric representation];

Práctica