DateAndTime.DateAdd Méthode

Source:

DateAndTime.vb

Source:

DateAndTime.vb

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 à laquelle 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 à l’avenir.

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 de 30 jours à partir d’aujourd’hui ou une heure de 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 vers le bas au dernier jour du mois résultant de l’année résultante. L’exemple suivant ajoute un mois à la date du 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 c’est #1/31/1996#le cas, il retourne #2/29/1996# parce que 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)
• Résumé du type de données (Visual Basic)

Source:

DateAndTime.vb

Source:

DateAndTime.vb

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 à laquelle 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 à l’avenir.

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 de 30 jours à partir d’aujourd’hui ou une heure de 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 vers le bas au dernier jour du mois résultant de l’année résultante. L’exemple suivant ajoute un mois à la date du 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 c’est #1/31/1996#le cas, il retourne #2/29/1996# parce que 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)
• Résumé du type de données (Visual Basic)