Description
Valeur de type date/heure
Arguments
"typeIntervalle" est une chaîne indiquant le type d'intervalle de temps à ajouter.
"nIntervalles" est un nombre ou une expression numérique indiquant le nombre d'intervalles à ajouter. Cette valeur peut être positive (pour générer une valeur de type date/heure dans l'avenir) ou négative (pour générer une valeur de type date/heure dans le passé).
"dateHeureDébut" est la valeur de type date/heure à laquelle les intervalles doivent être ajoutés.
Valeurs d'argument
Les valeurs possibles pour typeIntervalle sont les suivantes :
Valeur de type intervalle | |
|---|
| |
| Trimestre (résultat = 1, 2, 3 ou 4) |
| |
| Jour de l'année (de 1 à 365 ou 366 lorsque il s'agit une année bissextile) |
| La partie jour de la date (1 à 31) |
| Jour de la semaine (de 1 à 7, le résultat dépendant du jour choisi pour "premierJourSemaine") |
| Semaine de l'année (de 1 à 53, avec "permierJourSemaine" et "premièreSemaineAnnée" pour déterminer les jours exacts de la première semaine de l'année civile) |
| Extrait la partie horaire de la DateHeure donnée (de 0 à 23) |
| Partie des minutes (de 0 à 59) |
| Partie des secondes (de 0 à 59) |
Résultat
Valeur de type date/heure
Action
DateAdd renvoie une valeur de type date/heure à laquelle a été ajouté le nombre d'intervalles indiqué.
Exemple d'utilisation
DateAdd permet d'ajouter des intervalles de temps à une valeur de type date/heure. La principale caractéristique de cette fonction est que la valeur de type date/heure renvoyée est toujours correcte. Par exemple, DateAdd tient compte du nombre de jours des différents mois et des années bissextiles. Si vous souhaitez ajouter ou soustraire des jours à dateHeure, vous pouvez utiliser les opérateurs d'addition et de soustraction au lieu de DateAdd en lui ajoutant le paramètre "d". Toutefois, la fonction DateAdd est plus complète, dans la mesure où elle permet également de gérer d'autres types d'intervalles de temps, par exemple ajouter des mois ou des jours à une valeur de type date/heure.
Exemples
DateAdd("d", -32, #Sept 28, 1999#)Renvoie la valeur de type date/heure pour le 27 août 1999.
DateAdd ("m", 1, #1/31/1996#)Renvoie la valeur de type date/heure pour le 29 février 1996. Notez que DateAdd ne renverra pas la valeur non valide "31 février 1996".
DateAdd ("q", 17, #Sept 28, 1999#)Renvoie la valeur de type date/heure pour le 28.12.03.
DateAdd ("h", -400, #Sept 28, 1999#)Renvoie la valeur de type date/heure pour le 11 septembre 1998 8:00:00. En d'autres termes, ce résultat est obtenu par la soustraction de 400 heures du 28 septembre 1999 12:00:00.
Commentaires
Pour ajouter des jours à une valeur de type date/heure, vous pouvez utiliser l'un des types d'intervalle de temps disponibles, soit "y", "d" ou "w". Ces paramètres se comportent de manière semblable avec DateAdd.
DateAdd renvoie une valeur de type date/heure et non une valeur de date. Dans certains cas, vous devrez convertir cette valeur de type date/heure en valeur de date (par exemple, pour affecter à une variable de type date la valeur renvoyée par DateAdd). Pour effectuer cette conversion, il suffit d'utiliser DateAdd en combinaison avec la fonction de conversion CDate. Par exemple, la fonction suivante renvoie la valeur de date pour le 6 octobre 1997 :
CDate(DateAdd("yyyy", -2, #October 6, 1999#))