DATETIME_ADD

Añade un intervalo de tiempo especificado a una fecha o a una fecha y hora.

Ejemplo de uso

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Sintaxis

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Parámetros

  • datetime_expression - campo o expresión de fecha o de fecha y hora.
  • integer - campo o expresión numérico entero que representa el número de partes que se van a sumar.
  • part - unidad de medida de tiempo que se va a añadir. DATETIME_ADD admite los siguientes valores para part:
    • MICROSECOND: disponible para campos o expresiones de fecha y hora.
    • MILLISECOND: disponible para campos o expresiones de fecha y hora.
    • SECOND: disponible para campos o expresiones de fecha y hora.
    • MINUTE: disponible para campos o expresiones de fecha y hora.
    • HOUR: disponible para campos o expresiones de fecha y hora.
    • DAY
    • WEEK: esta parte de la fecha empieza en domingo.
    • ISOWEEK: usa los límites de la semana ISO 8601. Las semanas ISO comienzan en lunes.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: utiliza el estándar de numeración anual ISO 8601 por fecha semanal. Según este estándar, el año empieza el lunes de la primera semana que contiene el primer jueves del mismo año según el calendario gregoriano.

Tipo de datos devueltos

Fecha y hora

Ejemplos

Fórmula de ejemplo Salida
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

25 de enero del 2023 a las 15:40:00

DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

30 de enero del 2023 a las 00:00:00

Notas

Esta función no está disponible para los tipos de fecha del modo de compatibilidad.

Al usar las partes MONTH, QUARTER o YEAR, si la fecha resultante es el último día del mes (o una fecha próxima), DATETIME_ADD devuelve el último día del mes. Esto puede ocurrir si el mes de la fecha resultante tiene menos días que el de la fecha de inicio.

Por ejemplo, si Date = 31 de agosto del 2020, DATETIME_ADD(Date, INTERVAL 1 MONTH) devuelve 30 de septiembre del 2020.