DATETIME_ADD

Agrega 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: Es un campo o una expresión de fecha o fecha y hora.
  • integer: Es un campo o una expresión numérica entera que representa la cantidad de partes que se agregarán.
  • part: Es la unidad de medida de tiempo que se agregará. 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 comienza el día domingo.
    • ISOWEEK: Usa los límites de la semana ISO 8601. Las semanas ISO comienzan el lunes.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: Usa el límite del año de numeración de semana ISO 8601. El límite del año ISO es el lunes de la primera semana cuyo jueves pertenece al año calendario gregoriano correspondiente.

Tipo de datos que se muestra

Fecha y hora

Ejemplos

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

25 de enero de 2023, 3:40:00 p.m.

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

30 de enero de 2023, 12:00:00 a.m.

Notas

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

Cuando se usan las partes MONTH, QUARTER o YEAR, si la fecha resultante es el último día del mes (o está cerca de él), DATETIME_ADD devuelve el último día del mes. Esto puede ocurrir cuando el mes de la fecha resultante tiene menos días que el mes de la fecha de inicio.

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