HOWTO · PHP

Cómo convertir una cadena a fecha y hora en PHP

Diferentes formas de convertir una cadena a un formato de fecha y fecha-hora con funciones de PHP, como la combinación de `strtotime()` y `date()`, o mediante `DateTime::createFromFormat()` o `date_create_from_format()`.

En esta página

Una cadena de fecha es texto hasta que PHP la analiza. El análisis interpreta ese texto como una marca de tiempo o un objeto de fecha y hora; después, el formateo convierte el valor analizado en la representación que necesita tu aplicación. Elige strtotime() cuando la entrada sea una expresión de fecha habitual y sin ambigüedades. Si sigue un patrón conocido, prefiere un formato explícito con DateTime::createFromFormat() o su alternativa procedimental, date_create_from_format().

Elige el enfoque adecuado para analizar fechas en PHP

Usa strtotime() con cadenas habituales, como una fecha de estilo ISO, cuando sea aceptable una interpretación flexible. Devuelve una marca de tiempo Unix o false, y date() da formato a esa marca de tiempo. Para un patrón de entrada fijo, el método DateTime::createFromFormat() especifica el orden esperado de los campos y devuelve un objeto de fecha y hora o false. La función procedimental date_create_from_format() ofrece el mismo tipo de análisis sin llamar directamente al método estático.

Estas funciones no eliminan la ambigüedad de una entrada. Si los usuarios pueden introducir fechas según convenciones distintas, define y valida el formato esperado en el punto de entrada. En todos los casos, elige deliberadamente la zona horaria al interpretar una fecha y hora; de lo contrario, se usa la zona horaria predeterminada configurada en PHP.

Analiza cadenas de fecha flexibles con strtotime() y date()

Para una cadena de fecha y hora habitual, analízala con strtotime() y pasa la marca de tiempo devuelta a date(). Comprueba si el resultado es false antes de dar formato al valor, para no usar como marca de tiempo el resultado de un análisis fallido. El ejemplo utiliza una entrada y un formato de salida fijos, por lo que el resultado es reproducible con independencia de la hora actual de la máquina.

Ejecuta este ejemplo. Las etiquetas y los mensajes visibles dentro del bloque de código permanecen en inglés.

<?php
$dateString = '2023-10-15 14:30:00';
$timestamp = strtotime($dateString);

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

strtotime() acepta muchas expresiones textuales de fecha, pero esa flexibilidad no sustituye a declarar un formato de entrada. El resultado representa un instante interpretado según las reglas de zona horaria; date() da formato a la marca de tiempo usando la zona horaria predeterminada de PHP. Si el origen tiene una zona horaria conocida, inclúyela o aplícala explícitamente en lugar de depender de la configuración del servidor.

Analiza un formato conocido con DateTime::createFromFormat()

Cuando la cadena tenga una estructura definida, proporciona la cadena de formato correspondiente. En el formato siguiente, d, m, Y, H e i representan el día, el mes, el año de cuatro dígitos, la hora y los minutos. El ! inicial restablece los campos que no aparecen en la entrada, en vez de heredar los segundos de la fecha actual u otros campos.

Las etiquetas y los mensajes visibles dentro del bloque de código permanecen en inglés.

<?php
$dateString = '15-10-2023 14:30';
$dateFormat = '!d-m-Y H:i';
$dateTime = DateTime::createFromFormat($dateFormat, $dateString);

if ($dateTime === false) {
    echo "Could not parse the date string.";
} else {
    echo $dateTime->format('Y-m-d H:i:s');
}

El formato debe describir la entrada, no la salida deseada. Después del análisis, llama a format() con el patrón de salida que quieras. Que el resultado no sea false no garantiza por sí solo que todos los componentes de la fecha se hayan aceptado exactamente como se esperaba: PHP puede normalizar algunos valores fuera de rango y emitir advertencias. Para validar estrictamente la entrada, inspecciona DateTime::getLastErrors() después del análisis, como se explica más adelante.

Usa la función procedimental date_create_from_format()

La función procedimental resulta útil en código que ya utiliza las funciones de fecha de PHP. Acepta el mismo formato y la misma cadena de entrada, y devuelve un objeto DateTime si el análisis tiene éxito o false si falla. Da formato al objeto devuelto con date_format() solo después de comprobar que sea un objeto.

Las etiquetas y los mensajes visibles dentro del bloque de código permanecen en inglés.

<?php
$dateString = '2023/10/15 14:30';
$dateFormat = '!Y/m/d H:i';
$dateTime = date_create_from_format($dateFormat, $dateString);

if ($dateTime === false) {
    echo "Could not parse the date string.";
} else {
    echo date_format($dateTime, 'Y-m-d H:i:s');
}

Esta es la alternativa procedimental a DateTime::createFromFormat(): ambas opciones analizan la entrada según el formato proporcionado y producen un objeto DateTime. Elige el estilo que mejor encaje con el código que lo rodea. No hace falta basar la elección en una afirmación sobre la versión de PHP; consulta la documentación de la versión compatible con tu aplicación para comprobar la disponibilidad de la API.

Gestiona entradas ambiguas, errores de análisis y zonas horarias

Una cadena como 03/04/2023 puede significar el 4 de marzo o el 3 de abril, según la convención. No te bases solo en los separadores para determinar su significado. Si el origen tiene una estructura conocida, pasa su formato exacto a DateTime::createFromFormat() y valida el resultado. strtotime() resulta práctico para cadenas convencionales y claramente especificadas, pero no puede deducir qué convención pretendía el usuario.

DateTime::createFromFormat() y date_create_from_format() pueden devolver false; comprueba el resultado antes de llamar a un método del objeto o a date_format(). También pueden aceptar un valor y, a la vez, informar de advertencias de análisis, por ejemplo, cuando PHP normaliza un componente de la fecha. Si necesitas que la fecha del calendario sea válida con exactitud, comprueba también los diagnósticos del análisis:

Las etiquetas y los mensajes visibles dentro del bloque de código permanecen en inglés.

<?php
$dateTime = DateTime::createFromFormat('!Y-m-d', '2023-02-31');
$errors = DateTime::getLastErrors();

if ($dateTime === false || ($errors !== false && ($errors['warning_count'] > 0 || $errors['error_count'] > 0))) {
    echo "The date is not valid for the specified format.";
} else {
    echo $dateTime->format('Y-m-d');
}

El ! restablece los campos no especificados, mientras que getLastErrors() informa de las advertencias y los errores del análisis más reciente. Los detalles de diagnóstico pueden variar entre versiones de PHP, así que prueba la política de validación en las versiones compatibles con tu aplicación. Para fechas y horas de una región concreta, crea un DateTimeZone para esa región y pásalo como tercer argumento a DateTime::createFromFormat() (o como argumento de zona horaria correspondiente a la función procedimental). Si la entrada contiene un desplazamiento UTC explícito, conserva o convierte ese desplazamiento de forma deliberada antes de dar formato al valor para mostrarlo.