DATEADD (espressione SSIS)DATEADD (SSIS Expression)

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.Returns a new DT_DBTIMESTAMP value after adding a number that represents a date or time interval to the specified datepart in a date. Il parametro number deve restituire un valore integer e il parametro date deve restituire una data valida.The number parameter must evaluate to an integer, and the date parameter must evaluate to a valid date.

SintassiSyntax


DATEADD(datepart, number, date)  

ArgomentiArguments

parte di una datadatepart
Parametro che specifica la parte della data a cui aggiungere il numero.Is the parameter that specifies which part of the date to add a number to.

numbernumber
Valore usato per incrementare il valore datepart.Is the value used to increment datepart. Deve essere un valore integer noto al momento dell'analisi dell'espressione.The value must be an integer value that is known when the expression is parsed.

datadate
Espressione che restituisce una data valida o una stringa con formato di data.Is an expression that returns a valid date or a string in date format.

Tipi restituitiResult Types

DT_DBTIMESTAMPDT_DBTIMESTAMP

OsservazioniRemarks

Nella tabella seguente sono elencate le parti della data e le abbreviazioni riconosciute dall'analizzatore di espressioni.The following table lists the dateparts and abbreviations recognized by the expression evaluator. Per i nomi delle parti della data non viene fatta distinzione tra maiuscole e minuscole.Datepart names are not case sensitive.

parte di una dataDatepart AbbreviazioniAbbreviations
YearYear yy, yyyyyy, yyyy
QuarterQuarter qq, qqq, q
MonthMonth mm, mmm, m
DayofyearDayofyear dy, ydy, y
DayDay dd, ddd, d
WeekWeek wk, wwwk, ww
Giorno ferialeWeekday dw, wdw, w
OraHour HhHh
MinutoMinute mi, nmi, n
SecondoSecond ss, sss, s
MillisecondMillisecond MsMs

L'argomento number deve essere disponibile al momento dell'analisi dell'espressione.The number argument must be available when the expression is parsed. Può essere una costante o una variabile.The argument can be a constant or a variable. Non è possibile utilizzare valori di colonna, perché tali valori non sono noti al momento dell'analisi dell'espressione.You cannot use column values because the values are not known when the expression is parsed.

L'argomento datepart deve essere racchiuso tra virgolette.The datepart argument must be enclosed by quotation marks.

Per i valori letterali di data è necessario eseguire il cast esplicito a uno dei tipi di dati date.A date literal must be explicitly cast to one of the date data types. Per altre informazioni, vedere Tipi di dati di Integration Services.For more information, see Integration Services Data Types.

Se l'argomento è Null, DATEADD restituirà Null.DATEADD returns a null result if the argument is 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.Errors occur if a date is invalid, if the date or time unit is not a string, or if the increment is not a static integer.

Esempi di espressione SSISSSIS Expression Examples

In questo esempio viene aggiunto un mese alla data corrente.This example adds one month to the current date.

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

In questo esempio vengono aggiunti 21 giorni alle date nella colonna ModifiedDate .This example adds 21 days to the dates in the ModifiedDate column.

DATEADD("day", 21, ModifiedDate)  

In questo esempio vengono aggiunti 2 anni a un valore letterale data.This example adds 2 years to a literal date.

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

Vedere ancheSee Also

DATEDIFF ( Espressione SSIS ) DATEDIFF (SSIS Expression)
DATEPART ( Espressione SSIS ) DATEPART (SSIS Expression)
GIORNO ( Espressione SSIS ) DAY (SSIS Expression)
MESE ( Espressione SSIS ) MONTH (SSIS Expression)
ANNO ( Espressione SSIS ) YEAR (SSIS Expression)
Funzioni ( Espressione SSIS )Functions (SSIS Expression)