DATETIME_DIFF

Restituisce il numero di limiti di parti tra due date.

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 di data o data e ora. Se la prima espressione della data è precedente alla seconda, il risultato è zero o negativo. DATETIME_DIFF restituisce un errore se il calcolo supera il tipo di risultato, ad esempio se la differenza in microsecondi tra i due valori di data fosse superiore a un valore intero.

part: la parte dell'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.

Formula Risultato

Formula	Risultato
`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

DATETIME_DIFF(
   DATETIME "2010-07-07 10:20:00", DATETIME "2008-12-25 15:30:00", DAY
)

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

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

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.

Formula	Risultato
`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. DATETIME_DIFF con la parte della data ISOWEEK restituisce anche 1 perché le settimane ISO iniziano di lunedì.

Formula	Risultato
`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à.

Risorse correlate

È stato utile?

Come possiamo migliorare l'articolo?