DATETIME_DIFF

Esempi di utilizzo

DATETIME_DIFF(Order Date, Ship Date, DAY)

Sintassi

DATETIME_DIFF( date_expression, date_expression, part )

Parametri

  • date_expression: un'espressione o un campo per la data o per la data e l'ora. Se la prima espressione della data è precedente alla seconda, il risultato è zero o negativo.
  • part: la parte di ora da restituire. DATETIME_DIFF supporta le seguenti parti:
    • 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

Numero (intero)

Esempi

Il secondo e il terzo esempio riportati di seguito mostrano il risultato di DATETIME_DIFF per due valori di data a 24 ore di distanza. DATETIME_DIFF con la parte WEEK restituisce 1 perché DATETIME_DIFF conteggia il numero di limiti di parti in questo intervallo di valori di data. Ogni WEEK inizia di domenica, quindi esiste un limite tra sabato 2017-10-14 00:00:00 e domenica 2017-10-15 00:00:00.

Esempio di formula Output
DATETIME_DIFF( DATETIME "2010-07-07 10:20:00", DATETIME "2008-12-25 15:30:00", DAY ) 559
DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", DAY )

1

DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", WEEK ) 1

L'esempio seguente mostra il risultato di DATETIME_DIFF per due date in anni diversi. DATETIME_DIFF con la parte della data YEAR restituisce 3 perché conteggia il numero di limiti dell'anno del calendario gregoriano tra i due valori di data. DATETIME_DIFF con la parte della data ISOYEAR restituisce 2 perché il secondo valore di data appartiene all'anno ISO 2015. Il primo giovedì dell'anno di calendario 2015 corrispondeva al giorno 2015-01-01, per cui l'anno ISO 2015 inizia il lunedì precedente, ovvero in data 2014-12-29.

Esempio di formula Output
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', YEAR) 3
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', ISOYEAR)

2

L'esempio seguente mostra il risultato di DATETIME_DIFF per due giorni consecutivi. La prima data cade di lunedì e la seconda di domenica. Anche DATETIME_DIFF con la parte della data ISOWEEK restituisce 1 perché le settimane ISO iniziano di lunedì.

Esempio di formula Output
DATETIME_DIFF(DATE '2017-12-18', DATE '2017-12-17', WEEK) 0
DATETIME_DIFF(DATE '2017-12-18', DATE'2017-12-17', ISOWEEK) 1

Note

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