Condividi tramite


Funzione DATEADD

La funzione DATEADD esegue calcoli di data e ora per le proprietà corrispondenti con tipi di data. Utilizzare la funzione DATEADD per ottenere date e ore in un intervallo di tempo specificato prima del presente.

Sintassi

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Argomenti

DateTimeUnits

Specifica le unità del parametro DateTime : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE o SECOND. Questo valore fa distinzione tra maiuscole e minuscole e le virgolette non sono necessarie per il parametro .

OffsetValue

Specifica l'offset temporale, nelle unità specificate dal parametro DateTimeUnits . OffsetValue deve essere un numero intero negativo. I valori positivi non sono supportati.

DateTime

Specifica un timestamp da cui calcolare l'offset. Non può essere un valore letterale data. Deve essere GETGMTDATE o il risultato di un'altra funzione DATEADD.

Commenti

La funzione DATEADD può essere utilizzata solo nei confronti dei valori letterali e solo sul lato destro dell'operatore di confronto.

La funzione GETGMTDATE restituisce la data e l'ora correnti in Greenwich Mean Time (GMT). Tenere presente che questo valore potrebbe non corrispondere all'ora locale del computer.

Non usare l'operatore di confronto equals (=) perché la rappresentazione temporale interna può produrre errori di arrotondamento che generano risultati di corrispondenza imprevisti.

È possibile utilizzare più funzioni DATEADD per combinare le unità di offset.

Esempio

Nell'esempio seguente la clausola WHERE corrisponde ai documenti modificati negli ultimi cinque giorni:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

Nell'esempio seguente la clausola WHERE corrisponde ai documenti modificati negli ultimi due giorni e quattro ore:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

Riferimento

Confronto tra valori letterali

Confronti tra valori multivalore (ARRAY)

Informazioni concettuali

Predicati full-text

Predicati non full-text