Condividi tramite


DateAndTime.DateAdd Metodo

Definizione

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

Overload

DateAdd(DateInterval, Double, DateTime)

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

DateAdd(String, Double, Object)

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

DateAdd(DateInterval, Double, DateTime)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

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

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

Interval
DateInterval

Obbligatorio. Valore dell'enumerazione DateInterval o espressione String che rappresenta l'intervallo di tempo da aggiungere.

Number
Double

Obbligatorio. Espressione a virgola mobile che rappresenta il numero di intervalli che si desidera aggiungere. Può essere positivo (per ottenere valori di data/ora nel futuro) o negativo (per ottenere valori di data/ora nel passato). Può contenere una parte frazionaria se Interval specifica ore, minuti o secondi. Per gli altri valori di Interval, un'eventuale parte frazionaria di Number viene ignorata.

DateValue
DateTime

Obbligatorio. Espressione che rappresenta la data e l'ora a cui aggiungere l'intervallo. L'oggetto DateValue stesso non viene modificato nel programma chiamante.

Restituisce

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

Eccezioni

DateValue non può essere assegnato forzatamente a un valore Date.

Interval non è valido.

La data calcolata è precedente alle 00.00.00 dell'1 gennaio dell'anno 1 o successiva alle 23.59.59 del 31 dicembre 9999.

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.

Nota

DateAddusa l'impostazione del CultureInfo calendario corrente dalla CurrentCulture proprietà della classe nello System.Globalization spazio dei nomi. I valori predefiniti CurrentCulture sono determinati dalle impostazioni di Pannello di controllo.

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.

Valore di enumerazione string Unità di intervallo di tempo da aggiungere
DateInterval.Day d Giorno; troncato al valore integrale
DateInterval.DayOfYear y Giorno; troncato al valore integrale
DateInterval.Hour h Ora; arrotondato al millisecondo più vicino
DateInterval.Minute n Minuto; arrotondato al millisecondo più vicino
DateInterval.Month m Mese; troncato al valore integrale
DateInterval.Quarter q Quarto; troncato al valore integrale
DateInterval.Second s Secondo; arrotondato al millisecondo più vicino
DateInterval.Weekday w Giorno; troncato al valore integrale
DateInterval.WeekOfYear ww Settimana; troncato al valore integrale
DateInterval.Year aaaa Anno; troncato al valore integrale

Vedi anche

Si applica a

DateAdd(String, Double, Object)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

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

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

Interval
String

Obbligatorio. Valore dell'enumerazione DateInterval o espressione String che rappresenta l'intervallo di tempo da aggiungere.

Number
Double

Obbligatorio. Espressione a virgola mobile che rappresenta il numero di intervalli che si desidera aggiungere. Number può essere positivo (per ottenere valori di data/ora nel futuro) o negativo (per ottenere valori di data/ora nel passato). Può contenere una parte frazionaria se Interval specifica ore, minuti o secondi. Per gli altri valori di Interval, un'eventuale parte frazionaria di Number viene ignorata.

DateValue
Object

Obbligatorio. Espressione che rappresenta la data e l'ora a cui aggiungere l'intervallo. L'oggetto DateValue stesso non viene modificato nel programma chiamante.

Restituisce

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

Eccezioni

DateValue non può essere assegnato forzatamente a un valore Date.

Interval non è valido.

La data calcolata è precedente alle 00.00.00 dell'1 gennaio dell'anno 1 o successiva alle 23.59.59 del 31 dicembre 9999.

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.

Nota

DateAddusa l'impostazione del CultureInfo calendario corrente dalla CurrentCulture proprietà della classe nello System.Globalization spazio dei nomi. I valori predefiniti CurrentCulture sono determinati dalle impostazioni di Pannello di controllo.

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.

Valore di enumerazione string Unità di intervallo di tempo da aggiungere
DateInterval.Day d Giorno; troncato al valore integrale
DateInterval.DayOfYear y Giorno; troncato al valore integrale
DateInterval.Hour h Ora; arrotondato al millisecondo più vicino
DateInterval.Minute n Minuto; arrotondato al millisecondo più vicino
DateInterval.Month m Mese; troncato al valore integrale
DateInterval.Quarter q Quarto; troncato al valore integrale
DateInterval.Second s Secondo; arrotondato al millisecondo più vicino
DateInterval.Weekday w Giorno; troncato al valore integrale
DateInterval.WeekOfYear ww Settimana; troncato al valore integrale
DateInterval.Year aaaa Anno; troncato al valore integrale

Vedi anche

Si applica a