Syntaxes Basic et Crystal
Arguments
"typeIntervalle" est une chaîne indiquant le type d'intervalle de temps à ajouter. Valeurs possibles :
Valeur de type intervalle Description
yyyy
Année
q
Trimestre (période de trois mois)
m
Mois
y
Jour de l'année
d
Jour
w
Jour de semaine
ww
Semaine (période de 7 jours)
h
Heure
n
Minute
s
Seconde
"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.
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
Les exemples suivants sont applicables aux syntaxes Basic et Crystal :
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
Cette fonction est conçue pour fonctionner comme la fonction qui porte le même nom dans Visual Basic.
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#))
Partager