TIMESTAMPADD

La funcion TIMESTAMPADD suma un intervalo expresado en una unidad específica a un valor de fecha o datetime. Es la contrapartida natural de TIMESTAMPDIFF: mientras que TIMESTAMPDIFF mide cuántas unidades separan dos fechas, TIMESTAMPADD avanza (o retrocede) una fecha la cantidad de unidades que indiques.

Sintaxis

TIMESTAMPADD(unidad, intervalo, datetime)

El primer argumento es la unidad del intervalo. Las unidades válidas son SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER y YEAR. El segundo argumento es un número entero que indica cuántas unidades sumar (puede ser negativo para restar). El tercer argumento es el valor DATE o DATETIME al que se aplica la operación.

Comportamiento básico

Sumar 15 días a una fecha:

SELECT TIMESTAMPADD(DAY, 15, '2026-03-01') AS resultado;

La sintaxis es directa: unidad, cantidad, fecha. Para sumar meses, años o cualquier otra unidad, simplemente cambias el primer argumento:

SELECT
    TIMESTAMPADD(MONTH, 3, '2026-01-15') AS mas_3_meses,
    TIMESTAMPADD(YEAR, 2, '2026-01-15') AS mas_2_anios,
    TIMESTAMPADD(QUARTER, 1, '2026-01-15') AS mas_1_trimestre;

Al sumar meses, TIMESTAMPADD ajusta el día cuando el mes destino tiene menos días que el mes origen, igual que DATE_ADD:

SELECT TIMESTAMPADD(MONTH, 1, '2026-01-31') AS resultado;

Enero tiene 31 días pero febrero solo 28, así que MySQL ajusta al último día válido del mes.

Para sumar horas, minutos o segundos, el argumento de entrada debería incluir el componente horario:

SELECT
    TIMESTAMPADD(HOUR, 5, '2026-03-15 10:00:00') AS mas_5_horas,
    TIMESTAMPADD(MINUTE, 90, '2026-03-15 10:00:00') AS mas_90_min,
    TIMESTAMPADD(SECOND, 3600, '2026-03-15 10:00:00') AS mas_3600_seg;

Observa que sumar 90 minutos y sumar 3600 segundos (1 hora) producen resultados correctos, cruzando los límites de hora cuando es necesario.

Diferencia con DATE_ADD

TIMESTAMPADD y DATE_ADD logran el mismo resultado en la mayoría de los casos, pero tienen diferencias de sintaxis y estilo que vale la pena entender:

SELECT
    DATE_ADD('2026-03-15', INTERVAL 6 MONTH) AS con_date_add,
    TIMESTAMPADD(MONTH, 6, '2026-03-15') AS con_timestampadd;

El resultado es idéntico. Las diferencias principales son estas: DATE_ADD usa la sintaxis INTERVAL expr unidad y admite intervalos compuestos como DAY_HOUR o YEAR_MONTH, que TIMESTAMPADD no soporta. Por otro lado, TIMESTAMPADD tiene una sintaxis funcional pura con tres argumentos separados por comas, lo que puede ser más fácil de construir dinámicamente en código de aplicación.

En general, usa DATE_ADD cuando trabajes directamente en SQL y necesites intervalos compuestos o la sintaxis + INTERVAL. Usa TIMESTAMPADD cuando necesites simetría con TIMESTAMPDIFF o cuando la sintaxis funcional encaje mejor en tu código.

Restar tiempo con valores negativos

Un valor negativo en el segundo argumento convierte la suma en una resta:

SELECT
    TIMESTAMPADD(DAY, -10, '2026-03-15') AS menos_10_dias,
    TIMESTAMPADD(MONTH, -3, '2026-06-15') AS menos_3_meses,
    TIMESTAMPADD(HOUR, -8, '2026-03-15 20:00:00') AS menos_8_horas;

Esto hace que TIMESTAMPADD sea una función bidireccional: con un solo conocimiento de la función puedes tanto avanzar como retroceder en el tiempo.

Caso práctico: programación de tareas recurrentes

En un sistema de gestión de tareas, cada tarea tiene una frecuencia de recurrencia expresada en unidad y cantidad. TIMESTAMPADD permite calcular la próxima ejecución de forma genérica:

SELECT
    t.nombre_tarea,
    t.ultima_ejecucion,
    t.frecuencia_valor,
    t.frecuencia_unidad,
    CASE t.frecuencia_unidad
        WHEN 'HOUR' THEN TIMESTAMPADD(HOUR, t.frecuencia_valor, t.ultima_ejecucion)
        WHEN 'DAY' THEN TIMESTAMPADD(DAY, t.frecuencia_valor, t.ultima_ejecucion)
        WHEN 'WEEK' THEN TIMESTAMPADD(WEEK, t.frecuencia_valor, t.ultima_ejecucion)
        WHEN 'MONTH' THEN TIMESTAMPADD(MONTH, t.frecuencia_valor, t.ultima_ejecucion)
    END AS proxima_ejecucion
FROM tareas_programadas t
WHERE t.activa = 1
ORDER BY proxima_ejecucion;

El CASE selecciona la unidad dinámicamente según lo configurado en cada tarea. Este patrón es la base de cualquier sistema de scheduling basado en base de datos.

Caso práctico: generar series de fechas

TIMESTAMPADD es esencial para generar secuencias de fechas cuando necesitas crear un calendario o llenar huecos en reportes temporales. Combinada con una tabla de números auxiliar:

SELECT
    TIMESTAMPADD(DAY, n.num, '2026-02-01') AS fecha
FROM (
    SELECT 0 AS num UNION SELECT 1 UNION SELECT 2 UNION SELECT 3
    UNION SELECT 4 UNION SELECT 5 UNION SELECT 6
) n
ORDER BY fecha;

Esta técnica se utiliza frecuentemente en un LEFT JOIN contra una tabla de hechos para garantizar que los reportes incluyan todos los días del periodo, incluso aquellos sin datos:

SELECT
    calendario.fecha,
    COALESCE(SUM(p.total), 0) AS ventas_dia
FROM (
    SELECT TIMESTAMPADD(DAY, n.num, '2026-02-01') AS fecha
    FROM (SELECT 0 AS num UNION SELECT 1 UNION SELECT 2 UNION SELECT 3
          UNION SELECT 4 UNION SELECT 5 UNION SELECT 6) n
) calendario
LEFT JOIN pedidos p ON DATE(p.fecha_creacion) = calendario.fecha
GROUP BY calendario.fecha
ORDER BY calendario.fecha;

Sin la serie generada, los días sin ventas no aparecerían en el resultado. TIMESTAMPADD permite construir el esqueleto temporal completo.

Caso práctico: cálculo de fechas de vencimiento con gracia

Muchos sistemas aplican un periodo de gracia después del vencimiento. Puedes encadenar llamadas a TIMESTAMPADD para calcular ambas fechas:

SELECT
    c.nombre,
    f.numero_factura,
    f.fecha_emision,
    TIMESTAMPADD(DAY, 30, f.fecha_emision) AS fecha_vencimiento,
    TIMESTAMPADD(DAY, 45, f.fecha_emision) AS fin_periodo_gracia
FROM facturas f
JOIN clientes c ON f.cliente_id = c.id
WHERE f.pagada = 0
ORDER BY f.fecha_emision
LIMIT 4;

Manejo de NULL

Si el valor datetime o el intervalo es NULL, TIMESTAMPADD devuelve NULL:

SELECT
    TIMESTAMPADD(DAY, 5, NULL) AS fecha_nula,
    TIMESTAMPADD(DAY, NULL, '2026-03-15') AS intervalo_nulo;

Para proteger tus consultas, utiliza COALESCE o IFNULL según el contexto:

SELECT
    nombre,
    TIMESTAMPADD(MONTH, 12,
        COALESCE(fecha_ultimo_contrato, fecha_registro)
    ) AS fecha_revision
FROM clientes;

Combinación con otras funciones

TIMESTAMPADD funciona bien junto a TIMESTAMPDIFF para crear lógica de ida y vuelta temporal. Por ejemplo, calcular cuántos meses de antigüedad tiene un cliente y luego proyectar cuándo alcanzará el siguiente nivel:

SELECT
    c.nombre,
    c.fecha_registro,
    TIMESTAMPDIFF(MONTH, c.fecha_registro, CURDATE()) AS meses_antiguedad,
    CASE
        WHEN TIMESTAMPDIFF(MONTH, c.fecha_registro, CURDATE()) < 12
        THEN TIMESTAMPADD(MONTH, 12, c.fecha_registro)
        WHEN TIMESTAMPDIFF(MONTH, c.fecha_registro, CURDATE()) < 24
        THEN TIMESTAMPADD(MONTH, 24, c.fecha_registro)
        ELSE NULL
    END AS fecha_proximo_nivel
FROM clientes c
WHERE c.activo = 1
ORDER BY meses_antiguedad DESC
LIMIT 4;

Los clientes con más de 24 meses ya alcanzaron el nivel máximo (resultado NULL), mientras que los demás ven proyectada la fecha en la que subirán de nivel.

En el siguiente artículo veremos EXTRACT para extraer partes específicas de una fecha.