DATEADD (espressione SSIS)

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

Viene restituito un nuovo valore DT_DBTIMESTAMP dopo aver aggiunto alla parte specificata di una data un numero che rappresenta un intervallo di date o di ore. Il parametro number deve restituire un valore integer e il parametro date deve restituire una data valida.

Sintassi

  
DATEADD(datepart, number, date)  

Argomenti

datepart
Parametro che specifica la parte della data a cui aggiungere il numero.

numero
Valore usato per incrementare datepart. Deve essere un valore integer noto al momento dell'analisi dell'espressione.

date
Espressione che restituisce una data valida o una stringa con formato di data.

Tipi di risultato

DT_DBTIMESTAMP

Osservazioni:

Nella tabella seguente sono elencate le parti della data e le abbreviazioni riconosciute dall'analizzatore di espressioni. I nomi dei datepart non fanno distinzione tra maiuscole e minuscole.

parte della data Abbreviazioni
Anno sì, sìì
Trimestre qq, q
Mese mm, m
Giorno dell'anno dy, y
Giorno dd, d
Settimana WK, WW
Giorno feriale dw, w
Ore Hh
Minuto mi, n
Secondo ss, s
Millisecondo Sig.ra

L'argomento number deve essere disponibile al momento dell'analisi dell'espressione. L'argomento può essere una costante o una variabile. Non è possibile utilizzare valori di colonna, perché tali valori non sono noti al momento dell'analisi dell'espressione.

L'argomento datepart deve essere racchiuso tra virgolette.

Un valore letterale di data deve essere convertito esplicitamente tramite cast a uno dei tipi di dati data. Per altre informazioni, vedere Tipi di dati di Integration Services.

DATEADD restituisce un valore null se l'argomento è null.

Se la data non è valida, l'unità di data o tempo non è una stringa oppure l'incremento non è un valore integer statico, verrà generato un errore.

Esempi di espressione SSIS

In questo esempio viene aggiunto un mese alla data corrente.

DATEADD("Month", 1,GETDATE())  

In questo esempio vengono aggiunti 21 giorni alle date nella colonna ModifiedDate .

DATEADD("day", 21, ModifiedDate)  

Questo esempio aggiunge 2 anni a una data letterale.

DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")