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.

Osservazioni

La funzione DATEADD può essere usata 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 usare più funzioni DATEADD per combinare le unità di offset.

Esempi

La clausola WHERE di esempio seguente corrisponde ai documenti modificati negli ultimi cinque giorni:

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

La clausola WHERE di esempio seguente 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

confronto tra valori multivalore (ARRAY)

concettuale

predicati diFull-Text

predicati nonFull-Text