Partager via


DateAndTime.DateAdd Méthode

Définition

Retourne une valeur Date contenant une valeur de date et d'heure auxquelles un intervalle de temps spécifié a été ajouté.

Surcharges

DateAdd(DateInterval, Double, DateTime)

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

DateAdd(String, Double, Object)

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

DateAdd(DateInterval, Double, DateTime)

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

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

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

Interval
DateInterval

Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant l’intervalle de temps que vous souhaitez ajouter.

Number
Double

Obligatoire. Expression à virgule flottante représentant le nombre d'intervalles à ajouter. Peut être positif (pour obtenir des valeurs date/heure à venir) ou négatif (pour obtenir des valeurs date/heure passées). Elle peut contenir une partie décimale lorsque Interval spécifie des heures, minutes ou secondes. Pour les autres valeurs de Interval, toute partie décimale de Number est ignorée.

DateValue
DateTime

Obligatoire. Expression représentant la date et l'heure auxquelles l'intervalle doit être ajouté. DateValue proprement dit n'est pas modifié dans le programme appelant.

Retours

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

Exceptions

DateValue ne peut pas être converti en Date.

Interval n'est pas valide.

La date calculée est antérieure à 00:00:00 le 1er janvier de l'année 1 ou ultérieure à 23:59:59 le 31 décembre 9999.

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.

Notes

DateAdd utilise le paramètre de calendrier actuel de la CurrentCulture propriété de la CultureInfo classe dans l’espace de System.Globalization noms . Les valeurs par défaut CurrentCulture sont déterminées par Panneau de configuration paramètres.

É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.

Valeur d'énumération String Unité d’intervalle de temps à ajouter
DateInterval.Day d Jour; Tronqué en valeur intégrale
DateInterval.DayOfYear o Jour; Tronqué en valeur intégrale
DateInterval.Hour h Heure; arrondi à la milliseconde la plus proche
DateInterval.Minute n Minute; arrondi à la milliseconde la plus proche
DateInterval.Month m Mois; Tronqué en valeur intégrale
DateInterval.Quarter q Trimestre; Tronqué en valeur intégrale
DateInterval.Second s Deuxième; arrondi à la milliseconde la plus proche
DateInterval.Weekday w Jour; Tronqué en valeur intégrale
DateInterval.WeekOfYear ww Semaine; Tronqué en valeur intégrale
DateInterval.Year aaaa Année; Tronqué en valeur intégrale

Voir aussi

S’applique à

DateAdd(String, Double, Object)

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

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

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

Interval
String

Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant l’intervalle de temps que vous souhaitez ajouter.

Number
Double

Obligatoire. Expression à virgule flottante représentant le nombre d'intervalles à ajouter. Number peut être positif (pour obtenir des valeurs date/heure à venir) ou négatif (pour représenter des valeurs date/heure passées). Elle peut contenir une partie décimale lorsque Interval spécifie des heures, minutes ou secondes. Pour les autres valeurs de Interval, toute partie décimale de Number est ignorée.

DateValue
Object

Obligatoire. Expression représentant la date et l'heure auxquelles l'intervalle doit être ajouté. DateValue proprement dit n'est pas modifié dans le programme appelant.

Retours

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

Exceptions

DateValue ne peut pas être converti en Date.

Interval n'est pas valide.

La date calculée est antérieure à 00:00:00 le 1er janvier de l'année 1 ou ultérieure à 23:59:59 le 31 décembre 9999.

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.

Notes

DateAdd utilise le paramètre de calendrier actuel de la CurrentCulture propriété de la CultureInfo classe dans l’espace de System.Globalization noms . Les valeurs par défaut CurrentCulture sont déterminées par Panneau de configuration paramètres.

É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.

Valeur d'énumération String Unité d’intervalle de temps à ajouter
DateInterval.Day d Jour; Tronqué en valeur intégrale
DateInterval.DayOfYear o Jour; Tronqué en valeur intégrale
DateInterval.Hour h Heure; arrondi à la milliseconde la plus proche
DateInterval.Minute n Minute; arrondi à la milliseconde la plus proche
DateInterval.Month m Mois; Tronqué en valeur intégrale
DateInterval.Quarter q Trimestre; Tronqué en valeur intégrale
DateInterval.Second s Deuxième; arrondi à la milliseconde la plus proche
DateInterval.Weekday w Jour; Tronqué en valeur intégrale
DateInterval.WeekOfYear ww Semaine; Tronqué en valeur intégrale
DateInterval.Year aaaa Année; Tronqué en valeur intégrale

Voir aussi

S’applique à