DateAndTime.DateAdd Méthode

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

Paramètres

Retours

Valeur contenant une valeur de date et d’heure auxquelles un intervalle de temps spécifié a été ajouté.

Exceptions

Exemples

Cet exemple prend une date et, à l’aide de la DateAdd fonction , affiche une date correspondante un nombre spécifié de mois dans le futur.

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)

Remarques

Vous pouvez utiliser la DateAdd fonction pour ajouter ou soustraire un intervalle de temps spécifié à partir d’une date. Par exemple, vous pouvez calculer une date 30 jours à partir d’aujourd’hui ou une heure 45 minutes avant maintenant.

Pour ajouter des jours à DateValue, vous pouvez utiliser DateInterval.Day, DateInterval.DayOfYearou DateInterval.Weekday. Ceux-ci sont traités comme équivalents, car DayOfYear et Weekday ne sont pas des intervalles de temps significatifs.

La DateAdd fonction ne retourne jamais de date non valide. Si nécessaire, la partie jour de la date résultante est ajustée à la baisse au dernier jour du mois résultant dans l’année résultante. L’exemple suivant ajoute un mois au 31 janvier :

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

Dans cet exemple, DateAdd retourne #2/28/1995#, et non #2/31/1995#. Si DateValue a la valeur #1/31/1996#, elle retourne #2/29/1996# car 1996 est une année bissextile.

Étant donné que chaque Date valeur est prise en charge par une DateTime structure, ses méthodes vous offrent des options supplémentaires pour ajouter des intervalles de temps. Par exemple, vous pouvez ajouter un nombre fractionnaire de jours, arrondi à la milliseconde la plus proche, à une Date variable comme suit :

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

L’argument Interval peut avoir l’un des paramètres suivants.

Voir aussi

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Liste des types de données (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

Paramètres

Retours

Valeur contenant une valeur de date et d’heure auxquelles un intervalle de temps spécifié a été ajouté.

Exceptions

Exemples

Cet exemple prend une date et, à l’aide de la DateAdd fonction , affiche une date correspondante un nombre spécifié de mois dans le futur.

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)

Remarques

Vous pouvez utiliser la DateAdd fonction pour ajouter ou soustraire un intervalle de temps spécifié à partir d’une date. Par exemple, vous pouvez calculer une date 30 jours à partir d’aujourd’hui ou une heure 45 minutes avant maintenant.

Pour ajouter des jours à DateValue, vous pouvez utiliser DateInterval.Day, DateInterval.DayOfYearou DateInterval.Weekday. Ceux-ci sont traités comme équivalents, car DayOfYear et Weekday ne sont pas des intervalles de temps significatifs.

La DateAdd fonction ne retourne jamais de date non valide. Si nécessaire, la partie jour de la date résultante est ajustée à la baisse au dernier jour du mois résultant dans l’année résultante. L’exemple suivant ajoute un mois au 31 janvier :

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

Dans cet exemple, DateAdd retourne #2/28/1995#, et non #2/31/1995#. Si DateValue a la valeur #1/31/1996#, elle retourne #2/29/1996# car 1996 est une année bissextile.

Étant donné que chaque Date valeur est prise en charge par une DateTime structure, ses méthodes vous offrent des options supplémentaires pour ajouter des intervalles de temps. Par exemple, vous pouvez ajouter un nombre fractionnaire de jours, arrondi à la milliseconde la plus proche, à une Date variable comme suit :

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

L’argument Interval peut avoir l’un des paramètres suivants.

Voir aussi

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Liste des types de données (Visual Basic)