DATETIME_ADD

Esempi di utilizzo

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Sintassi

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Parametri

  • datetime_expression: un'espressione o un campo per la data o per la data e l'ora.
  • integer: un'espressione o un campo numerico intero che rappresenta il numero di parti da aggiungere.
  • part: l'unità di misura del tempo da aggiungere. DATETIME_ADD supporta i seguenti valori per part:
    • MICROSECOND: disponibile per le espressioni o i campi di data e ora.
    • MILLISECOND: disponibile per le espressioni o i campi di data e ora.
    • SECOND: disponibile per le espressioni o i campi di data e ora.
    • MINUTE: disponibile per le espressioni o i campi di data e ora.
    • HOUR: disponibile per le espressioni o i campi di data e ora.
    • DAY
    • WEEK: questa parte della data inizia di domenica.
    • ISOWEEK: utilizza i limiti delle settimane ISO 8601. Le settimane ISO iniziano di lunedì.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: utilizza il limite dell'anno con numerazione settimanale ISO 8601. Il limite dell'anno ISO corrisponde al lunedì della prima settimana il cui giovedì appartiene al corrispondente anno del calendario gregoriano.

Tipo di dati restituito

Data e ora

Esempi

Example formula Output
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

25 gen 2023, 15:40:00

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

30 gen 2023, 00:00:00

Note

Questa funzione non è disponibile per i tipi di date in modalità di compatibilità.

Se utilizzi le parti MONTH, QUARTER o YEAR e la data risultante corrisponde o è prossima all'ultimo giorno del mese, DATETIME_ADD restituisce l'ultimo giorno del mese. Questo può accadere quando il mese nella data risultante ha meno giorni rispetto al mese nella data di inizio.

Ad esempio, se Date = 31 agosto 2020, DATETIME_ADD(Date, INTERVAL 1 MONTH) restituisce 30 settembre 2020.