DateAndTime.DateAdd Metodo

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

public:
 static DateTime DateAdd(Microsoft::VisualBasic::DateInterval Interval, double Number, DateTime DateValue);

public static DateTime DateAdd (Microsoft.VisualBasic.DateInterval Interval, double Number, DateTime DateValue);

static member DateAdd : Microsoft.VisualBasic.DateInterval * double * DateTime -> DateTime

Public Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTime

Parametri

Restituisce

Valore contenente un valore di data e ora a cui è stato aggiunto un intervallo di tempo specifico.

Eccezioni

Esempio

Questo esempio accetta una data e, usando la DateAdd funzione, visualizza una data corrispondente un numero specificato di mesi in futuro.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

Commenti

È possibile usare la DateAdd funzione per aggiungere o sottraere un intervallo di tempo specificato da una data. Ad esempio, è possibile calcolare una data 30 giorni da oggi o una volta 45 minuti prima di ora.

Per aggiungere giorni a DateValue, è possibile usare DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday. Questi vengono considerati equivalenti perché DayOfYear e Weekday non sono intervalli di tempo significativi.

La DateAdd funzione non restituisce mai una data non valida. Se necessario, la parte del giorno della data risultante viene rettificata verso il basso all'ultimo giorno del mese risultante nell'anno risultante. Nell'esempio seguente viene aggiunto un mese al 31 gennaio:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

In questo esempio restituisce DateAdd#2/28/1995#, non #2/31/1995#. Se DateValue è #1/31/1996#, restituisce #2/29/1996# perché il 1996 è un anno saltato.

Poiché ogni Date valore è supportato da una DateTime struttura, i relativi metodi offrono opzioni aggiuntive nell'aggiunta di intervalli di tempo. Ad esempio, è possibile aggiungere un numero frazionaria di giorni, arrotondato al millisecondo più vicino, a una Date variabile come indicato di seguito:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

L'argomento Interval può avere una delle impostazioni seguenti.

Vedi anche

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Riepilogo dei tipi di dati (Visual Basic)

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);

public static DateTime DateAdd (string Interval, double Number, object? DateValue);

public static DateTime DateAdd (string Interval, double Number, object DateValue);

static member DateAdd : string * double * obj -> DateTime

Public Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTime

Parametri

Restituisce

Valore contenente un valore di data e ora a cui è stato aggiunto un intervallo di tempo specifico.

Eccezioni

Esempio

Questo esempio accetta una data e, usando la DateAdd funzione, visualizza una data corrispondente un numero specificato di mesi in futuro.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

Commenti

È possibile usare la DateAdd funzione per aggiungere o sottraere un intervallo di tempo specificato da una data. Ad esempio, è possibile calcolare una data 30 giorni da oggi o una volta 45 minuti prima di ora.

Per aggiungere giorni a DateValue, è possibile usare DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday. Questi vengono considerati equivalenti perché DayOfYear e Weekday non sono intervalli di tempo significativi.

La DateAdd funzione non restituisce mai una data non valida. Se necessario, la parte del giorno della data risultante viene rettificata verso il basso all'ultimo giorno del mese risultante nell'anno risultante. Nell'esempio seguente viene aggiunto un mese al 31 gennaio:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

In questo esempio restituisce DateAdd#2/28/1995#, non #2/31/1995#. Se DateValue è #1/31/1996#, restituisce #2/29/1996# perché il 1996 è un anno saltato.

Poiché ogni Date valore è supportato da una DateTime struttura, i relativi metodi offrono opzioni aggiuntive nell'aggiunta di intervalli di tempo. Ad esempio, è possibile aggiungere un numero frazionaria di giorni, arrotondato al millisecondo più vicino, a una Date variabile come indicato di seguito:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

L'argomento Interval può avere una delle impostazioni seguenti.

Vedi anche

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Riepilogo dei tipi di dati (Visual Basic)