Saltar a contenido

⌚ datetime_add

¿Qué es la función datetime_add?

La función datetime_add permite sumar o restar unidades de tiempo a una fecha concreta, generando así nuevas fechas. Es útil para cálculos como vencimientos, recordatorios o plazos ajustados a reglas temporales.


¿Cómo funciona la función datetime_add?

Sintaxis:

datetime_add([fecha_inicio], [unidades], "unidad", ajustar_ultimo_dia)

Parámetros:

  • fecha_inicio: Fecha base desde la cual se suman o restan unidades. Puede ser un campo de tipo fecha, texto con formato de fecha válido, o una fórmula cuyo resultado sea una fecha.
  • unidades: Número de unidades a sumar o restar. Puede ser un valor numérico directo (como +3 o -5), un campo numérico o una fórmula cuyo resultado sea un número.
  • unidad: Unidad de tiempo a añadir o restar. Debe ser un valor entre comillas ("...") con uno de los siguientes valores:
  • y: Años completos.
  • m: Meses completos.
  • w: Semanas completas.
  • d: Días completos.
  • hh: Horas completas.
  • mm: Minutos completos.
  • ss: Segundos completos.
  • “ajustar_ultimo_dia” (opcional): Flag que puede incluirse si se desea que, al sumar meses o años, el resultado se ajuste automáticamente al último día del mes en caso de que el día original no exista en el mes destino (por ejemplo, sumar 1 mes al 31 de enero resultaría en 29 de febrero o 28, según el año). El valor debe ser true o false

Ejemplos

datetime_add([fecha_inicio], 1, "m")
datetime_add([fecha_inicio], -2, "y", true)

Casos de uso típicos

  • Sumar 30 días a la fecha de creación de un registro.
  • Calcular fechas de vencimiento o renovación.
  • Restar tiempo para obtener fechas anteriores a un evento.
  • Asegurar que fechas caigan en el último día del mes si se parte de un día como el 31.

Consideraciones adicionales

  • Esta función permite tanto sumar como restar tiempo, dependiendo del signo del valor numérico introducido en el parámetro [unidades].
  • Si se introduce la unidad directamente (en vez de desde un campo), debe escribirse entre comillas: por ejemplo, "d".
  • El resultado puede visualizarse con el formato que se elija desde la configuración del campo.