DateAndTime.DateAdd Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeParamè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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Liste des types de données (Visual Basic)
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 -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimeParamè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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Liste des types de données (Visual Basic)
