DATEADD |
Ajoute à la date |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| DateAdd(interval,number,date) |
Paramètres
| Nom | Description | |
|---|---|---|
| interval | Ce paramètre permet d'indiquer le type d'intervalle de temps à ajouter : | |
| Valeur | Description | |
| "yyyy" | Cette valeur permet d'indiquer une année | |
| "q" | Cette valeur permet d'indiquer un trimestre | |
| "m" | Cette valeur permet d'indiquer un mois | |
| "y" | Cette valeur permet d'indiquer des jours dans l'année | |
| "d" | Cette valeur permet d'indiquer un jour | |
| "w" | Cette valeur permet d'indiquer un jour de semaine | |
| "ww" | Cette valeur permet d'indiquer une semaine de l'année | |
| "h" | Cette valeur permet d'indiquer l'heure | |
| "n" | Cette valeur permet d'indiquer les minutes | |
| "s" | Cette valeur permet d'indiquer les secondes | |
| number | Ce paramètre permet d'indiquer la quantité à appliquer à l'intervalle | |
| date | Ce paramètre permet d'indiquer la date sur laquelle il faut effectuer le calcul | |
Description
Cette fonction retourne une date avec une expression de temps ajouté.
Remarques
- La fonction permet d'ajouter ou de soustraire une période à une date : La fonction DateAdd calcule une nouvelle date en ajoutant un intervalle de temps à une date existante. Si la quantité indiquée est positive, la date est avancée; si elle est négative, la date est reculée. Cette fonction est très utilisée pour calculer des échéances, des délais ou des périodes de validité.
- Elle prend en charge plusieurs unités de temps : Le premier paramètre (interval) permet de choisir l'unité de temps à manipuler, comme les années ("yyyy"), les mois ("m"), les semaines ("ww"), les jours ("d"), les heures ("h"), les minutes ("n") ou les secondes ("s"). Cette diversité rend DateAdd très polyvalente. Une seule fonction suffit ainsi pour effectuer la plupart des calculs calendaires.
- Le nombre d'intervalles peut être positif ou négatif : Le deuxième paramètre (number) représente le nombre d'intervalles à ajouter ou à retrancher. Par exemple, DateAdd("d", 30, Date()) ajoute 30 jours à la date actuelle, tandis que DateAdd("m", -6, Date()) retire six mois. Cette possibilité facilite les calculs de périodes passées ou futures.
- La fonction gère automatiquement les changements de mois et d'année : Lorsque l'ajout dépasse la fin d'un mois ou d'une année, DateAdd effectue automatiquement les ajustements nécessaires. Par exemple, ajouter un mois au 15 décembre produira une date située en janvier de l'année suivante. Le développeur n'a donc pas besoin de gérer manuellement ces changements de calendrier.
- Elle tient compte des années bissextiles et de la longueur des mois : DateAdd respecte les règles du calendrier grégorien utilisées par Windows. Elle sait que certains mois comptent 30 jours, d'autres 31, et que le mois de février peut comporter 28 ou 29 jours selon l'année. Cette gestion automatique garantit des calculs de dates fiables.
- La fonction peut également manipuler les heures, les minutes et les secondes : DateAdd ne se limite pas aux dates; elle peut également ajouter ou retrancher des heures ("h"), des minutes ("n") ou des secondes ("s"). Elle est donc adaptée aux applications qui doivent gérer des horaires, des rendez-vous ou des journaux d'événements. Cette précision permet de traiter aussi bien des dates que des horodatages complets.
- Elle est fréquemment utilisée avec les fonctions Date et Now : Il est courant de combiner DateAdd avec Date() ou Now() afin de calculer une échéance à partir de la date ou de l'heure actuelle. Par exemple, DateAdd("d", 7, Date()) permet d'obtenir automatiquement la date située une semaine plus tard. Cette combinaison est très utilisée dans les applications de gestion.
- Elle est disponible dans les requêtes, les formulaires et le code VBA : La fonction DateAdd peut être utilisée dans les requêtes SQL, les champs calculés, les formulaires, les états et les modules VBA. Cette polyvalence permet d'effectuer des calculs de dates directement dans les expressions Access. Le comportement reste identique quel que soit le contexte d'utilisation.
- Elle est souvent associée à DateDiff et DatePart : DateAdd travaille très bien avec DateDiff, qui calcule un intervalle entre deux dates, et DatePart, qui extrait une partie d'une date. Ensemble, ces fonctions permettent de réaliser des traitements calendaires complets. Elles sont largement utilisées dans les applications de planification, de gestion de projets et de suivi administratif.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : DateAdd est présente depuis les premières versions de Microsoft Access et son comportement est resté stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continuent de produire les mêmes résultats lors d'une migration vers une version plus récente d'Access.
Exemple
Voici un exemple de comment utiliser la fonction DateAdd dans Microsoft Access :
DateAdd ("yyyy", 3, #22/11/2003#)
Résultat: '22/11/2006'
DateAdd ("q", 2, #22/11/2003#)
Résultat: '22/05/2004'
DateAdd ("m", 5, #22/11/2003#)
Résultat: '22/04/2004'
DateAdd ("n", 51, #22/11/2003 10:31:58 AM#)
Résultat: '22/11/2003 11:22:58 AM'
DateAdd("yyyy", -1, #22/11/2003#)
Résultat: '22/11/2002'
Exemple de code VBA
La fonction DateAdd peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LDate As Date
LDate = DateAdd ("s", 53, #22/11/2003 10:31:58 AM#)
Dans cet exemple, la variable appelée LDate contiendrait désormais la valeur «22/11/2003 10:32:51 AM».
Dernière mise à jour : Mardi, le 28 juillet 2015