DateAndTime.DateAdd Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeParametri
- 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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Riepilogo dei tipi di dati (Visual Basic)
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 -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimeParametri
- 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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Riepilogo dei tipi di dati (Visual Basic)
