Funciones PHP para fechas en español

Cursos Empresas Blog Live Conf Precios

Contenido del curso

No sé dónde empezar

Debugging

Cookies y sesiones

Manejo de excepciones

Trabajando con fechas

Modularización

Cierre

22
Qué aprendiste en el curso intermedio de PHP
04:03 min

Tomar examen

Funciones PHP para fechas en español

Resumen

Trabajar con fechas en PHP puede volverse repetitivo si escribes el mismo código una y otra vez. Por eso existen funciones personalizadas para manejar fechas en PHP que convierten timestamps en formatos legibles, suman tiempo con frases en español y traducen expresiones temporales sin esfuerzo. Si programas en PHP y quieres ahorrar horas de lógica, esto te interesa.

¿Cómo importar un archivo de funciones de fecha en PHP?

Lo primero es tener un archivo date.php con todas las funciones listas para reutilizar. Lo encuentras en la sección de aportes y enlaces de la clase [00:36].

Luego creas un archivo nuevo, por ejemplo retax-functions.php, y lo enlazas con una sola línea:

php require 'date.php';

Con eso tu archivo ya tiene acceso a todas las funciones que vas a usar a continuación.

¿Qué es un timestamp en PHP? Es el formato que combina año, mes, día, hora, minutos y segundos en un solo string. Es la forma estándar en la que tu código se comunica con bases de datos.

¿Cómo convertir un timestamp en una fecha legible?

La función getDateFromTimestamp recibe un string tipo 2022-04-25 y devuelve una fecha completamente legible en español [01:33].

Por ejemplo, ese mismo string se transforma en lunes, 25 de abril de 2022. Si prefieres una versión más compacta para un blog post o una tarjeta, usas la función de fecha corta y obtienes algo como 25/04/2022.

¿Y si necesitas trabajar con horas?

Ahí entra getTimeFromTimestamp. Le pasas 24:32:45 y te devuelve 12:32 p.m. Si le pasas 18:32:45, te devuelve 6:32 p.m. [02:38].

La función addDotsToHour se encarga del detalle estético: convierte pm en p.m. para que el formato luzca más cuidado.

¿Cómo obtener el día de la semana o traducir expresiones de tiempo?

Con getDayOfTheWeek le pasas un número y te devuelve el día. Si pasas 4, obtienes jueves [03:46]. Internamente es un switch case, aunque también podrías reescribirlo con la función match que vimos en clases anteriores.

Para traducciones, translateTime convierte expresiones cortas entre inglés y español:

translateTime('un día', false) devuelve one day.
translateTime('one day', true) devuelve un día.

El segundo parámetro indica si quieres traducir al español (true) o al inglés (false). Eso sí, esta función traduce de uno por uno, así que un buen reto es ampliarla para que acepte frases compuestas como un día, dos horas y cinco minutos [04:52].

¿Cómo sumar tiempo a una fecha con lenguaje natural?

Aquí está la joya del archivo: addTime. Le pasas un timestamp y un string en español describiendo cuánto tiempo quieres añadir [06:07].

Por ejemplo, partiendo de 2022-04-23 12:45:34:

Añadir un día más dos horas devuelve 2022-04-24 14:45:34.
Añadir un día más dos horas más tres semanas mueve la fecha varias semanas adelante.
Añadir un mes cambia el mes de 04 a 05.

La magia es que escribes la suma en español plano y PHP la interpreta. Esa flexibilidad la hereda directamente del lenguaje, y addTime solo orquesta el proceso.

¿Para qué sirve addTime en la práctica? Para calcular vencimientos, recordatorios o fechas futuras sin manipular objetos DateTime manualmente. Escribes la regla en español y obtienes el resultado.

¿Qué otras funciones de fecha vale la pena conocer?

El archivo trae varias utilidades extra que cubren casos comunes en cualquier proyecto:

timeDiff: resta dos fechas y devuelve un objeto DateInterval para que tú decidas qué extraer.
hourDiff: calcula la diferencia entre dos horas.
hourIsBetween: verifica si una hora cae dentro de un rango.
dateIsBetween: lo mismo, pero con fechas.
getFullDate: convierte un timestamp completo en una frase humana.

Esta última merece atención. Si le pasas 2022-03-14 16:35:45, te devuelve lunes 14 de marzo del 2022 a las 4:35 p.m. [08:48]. Pasas de un string sin sentido visual a una frase que cualquier usuario entiende.

¿Y si trabajas con timestamps de JavaScript?

También hay funciones para convertirlos al formato que PHP entiende. Es útil cuando recibes datos del frontend y necesitas guardarlos en base de datos sin pelearte con la zona horaria ni los milisegundos.

Te invito a leer el código de cada función, entender su lógica interna y, si te animas, agregar tus propias utilidades en la sección de aportes. Cuéntame en los comentarios qué función agregarías tú primero.

Beder Danilo Casa Condori

Estudiante

aqui les comparto el mio

<?php

/**
 * ARCHIVO: date_functions.php
 * DESCRIPCIÓN: Colección de 10 funciones útiles para el manejo de fechas en PHP.
 */

// --- 1. Obtener la fecha y hora actual en un formato específico ---
/**
 * Obtiene la fecha y hora actual formateada.
 * @param string $format El formato deseado (ej: 'Y-m-d H:i:s', 'd/m/Y').
 * @param string $timezone La zona horaria (ej: 'America/Lima', 'Europe/Madrid').
 * @return string La fecha y hora formateada.
 */
function getCurrentDateTime($format = 'Y-m-d H:i:s', $timezone = 'UTC') {
    $dt = new DateTime('now', new DateTimeZone($timezone));
    return $dt->format($format);
}

// --- 2. Formatear una fecha UNIX Timestamp a un formato legible ---
/**
 * Convierte un timestamp UNIX en una cadena de fecha formateada.
 * @param int $timestamp El timestamp UNIX.
 * @param string $format El formato deseado.
 * @return string La fecha formateada.
 */
function formatTimestamp($timestamp, $format = 'd-m-Y') {
    return date($format, $timestamp);
}

// --- 3. Calcular la diferencia en días entre dos fechas ---
/**
 * Calcula la diferencia en días entre dos fechas.
 * @param string $date1 Primera fecha (ej: '2023-01-01').
 * @param string $date2 Segunda fecha.
 * @return int El número de días de diferencia (valor absoluto).
 */
function getDateDifferenceInDays($date1, $date2) {
    $datetime1 = new DateTime($date1);
    $datetime2 = new DateTime($date2);
    $interval = $datetime1->diff($datetime2);
    return (int)$interval->format('%a');
}

// --- 4. Sumar o restar días a una fecha ---
/**
 * Agrega o quita días a una fecha dada.
 * @param string $date La fecha inicial (ej: '2025-10-20').
 * @param int $days El número de días a agregar o restar (negativo para restar).
 * @param string $format El formato de salida.
 * @return string La nueva fecha formateada.
 */
function addDaysToDate($date, $days, $format = 'Y-m-d') {
    $dt = new DateTime($date);
    $dt->modify("$days days");
    return $dt->format($format);
}

// --- 5. Validar si una cadena es una fecha válida ---
/**
 * Verifica si una cadena de texto es una fecha válida.
 * @param string $date La cadena a validar.
 * @param string $format El formato esperado (ej: 'Y-m-d', 'd/m/Y').
 * @return bool True si es válida, False en caso contrario.
 */
function isValidDate($date, $format = 'Y-m-d') {
    $dt = DateTime::createFromFormat($format, $date);
    return $dt && $dt->format($format) === $date;
}

// --- 6. Obtener el día de la semana de una fecha ---
/**
 * Devuelve el día de la semana (en español) de una fecha.
 * @param string $date La fecha (ej: '2025-10-20').
 * @param bool $full Nombre completo (ej: 'Lunes') o abreviado (ej: 'Lun').
 * @return string El nombre del día de la semana.
 */
function getDayOfWeek($date, $full = true) {
    // Configura el idioma a español para strftime
    setlocale(LC_TIME, 'es_ES.UTF-8', 'esp');
    $timestamp = strtotime($date);
    $format = $full ? '%A' : '%a';
    // strftime es sensible a la configuración local
    return strftime($format, $timestamp);
}

// --- 7. Convertir el formato de una fecha ---
/**
 * Cambia el formato de una fecha de entrada a un formato de salida diferente.
 * @param string $dateString La fecha en su formato original.
 * @param string $inputFormat El formato actual de la fecha (ej: 'd/m/Y').
 * @param string $outputFormat El formato deseado.
 * @return string|false La fecha en el nuevo formato, o false si la conversión falla.
 */
function convertDateFormat($dateString, $inputFormat, $outputFormat) {
    $dt = DateTime::createFromFormat($inputFormat, $dateString);
    return $dt ? $dt->format($outputFormat) : false;
}

// --- 8. Obtener el primer o último día del mes ---
/**
 * Obtiene el primer o último día del mes de una fecha dada.
 * @param string $date La fecha dentro del mes.
 * @param string $type 'first' para el primer día, 'last' para el último.
 * @param string $format El formato de salida.
 * @return string La fecha solicitada.
 */
function getMonthBoundary($date, $type = 'first', $format = 'Y-m-d') {
    $dt = new DateTime($date);
    if ($type === 'first') {
        $dt->modify('first day of this month');
    } else { // 'last'
        $dt->modify('last day of this month');
    }
    return $dt->format($format);
}

// --- 9. Calcular la edad a partir de una fecha de nacimiento ---
/**
 * Calcula la edad en años a partir de una fecha de nacimiento.
 * @param string $birthDate La fecha de nacimiento (ej: '1990-05-15').
 * @return int La edad en años.
 */
function calculateAge($birthDate) {
    $birth = new DateTime($birthDate);
    $now = new DateTime();
    $interval = $now->diff($birth);
    return (int)$interval->y;
}

// --- 10. Comprobar si un año es bisiesto ---
/**
 * Determina si un año específico es bisiesto.
 * @param int $year El año a comprobar.
 * @return bool True si es bisiesto, False en caso contrario.
 */
function isLeapYear($year) {
    return date('L', mktime(0, 0, 0, 1, 1, $year));
}

// ----------------------------------------------------------------
// EJEMPLO DE USO DE LAS FUNCIONES
// ----------------------------------------------------------------
echo "<h2>Ejemplo de Uso de Funciones de Fecha</h2>";

$fecha_ejemplo = '2024-11-06';
$fecha_ayer = '2024-11-05';
$fecha_nacimiento = '1985-03-22';
$timestamp = time();

echo "<ul>";
echo "<li>**1. Fecha y Hora Actual (Lima):** " . getCurrentDateTime('d/m/Y H:i:s', 'America/Lima') . "</li>";
echo "<li>**2. Timestamp Formateado:** " . formatTimestamp($timestamp, 'H:i:s - d M Y') . "</li>";
echo "<li>**3. Diferencia entre $fecha_ejemplo y $fecha_ayer (días):** " . getDateDifferenceInDays($fecha_ejemplo, $fecha_ayer) . "</li>";
echo "<li>**4. Sumar 5 días a $fecha_ejemplo:** " . addDaysToDate($fecha_ejemplo, 5) . "</li>";
echo "<li>**5. ¿Es '2024-15-40' una fecha válida (Y-m-d)?** " . (isValidDate('2024-15-40') ? 'Sí' : 'No') . "</li>";
echo "<li>**6. Día de la semana de $fecha_ejemplo (completo):** " . getDayOfWeek($fecha_ejemplo) . "</li>";
echo "<li>**7. Conversión de '06/11/2024' (d/m/Y) a Y-m-d:** " . convertDateFormat('06/11/2024', 'd/m/Y', 'Y-m-d') . "</li>";
echo "<li>**8. Último día del mes de $fecha_ejemplo:** " . getMonthBoundary($fecha_ejemplo, 'last') . "</li>";
echo "<li>**9. Edad a partir de $fecha_nacimiento:** " . calculateAge($fecha_nacimiento) . " años</li>";
echo "<li>**10. ¿Es 2024 un año bisiesto?** " . (isLeapYear(2024) ? 'Sí' : 'No') . "</li>";
echo "</ul>";

?>

Walter Omar Barrios Vazquez

Juan Pablo Campuzano Monsalve

Hector Vasquez

Juan David Rueda Quiroga

Remberto Alvaro Molina Colodro

Diego Frank Lipa Choque

Erick Estrada Mancilla

David Alejandro González Barba

Nelson Junior Moncada Pirela

Sergio Andrés Barragan

Bryan Castano

Alejandro Pérez Restrepo

humberto viveros

Uriel Zoe Sanjuán Morales

Ermilo Joel Dorantes Uc

Debugging

Debugging en PHP con dd y modularización

Debugging con dd de Symfony en PHP

Cookies y sesiones

Qué son las cookies y cómo usarlas en PHP

Atributos de setcookie en PHP

Sesiones en PHP con session_start

Sesiones en PHP: login y logout básico

Manejo de excepciones

Manejo de excepciones en PHP con try catch

Cómo implementar try catch en PHP

Métodos de la clase Exception en PHP

Creación de Excepciones Personalizadas en PHP

Trabajando con fechas

Fechas en PHP con date y DateTime

Fechas en PHP: funciones vs clases

Funciones de fechas útiles en PHP

Cómo calcular y modificar fechas en PHP