DATEADD (Générateur de rapports version 1.0)
Retourne un type de champ d'heure ou datetime résultant de l'ajout du nombre spécifié d'unités d'intervalles de temps au type de champ d'heure ou datetime d'origine. Le résultat est le même type de données que le champ d'heure ou datetime de début d'origine.
Syntaxe
DATEADD(interval, units, datetime)
interval |
Spécifie les unités (année [Year], trimestre [Quarter], mois [Month], jour [Day], heure [Hour], minute [Minute], seconde [Second] ou semaine [Week]) utilisées pour calculer l'ajout de dates ou d'heures. |
units |
Spécifie le nombre d'intervalles. |
datetime |
Spécifie la date ou l'heure de début à laquelle les intervalles sont ajoutés. |
Remarques
Si la formule ajoute plusieurs unités d'intervalles de temps à une heure de début, l'unité d'intervalle peut être uniquement HOUR, MINUTE ou SECOND.
Pour afficher une valeur de date et d'heure sous la forme d'une heure, vous devez mettre en forme le champ de façon à ce qu'il utilise l'une des chaînes de format DateTime personnalisées suivantes sous l'onglet Nombre de la boîte de dialogue Format : u, f ou s.
Les intervalles ne respectent pas la casse.
Les intervalles suivants sont valides :
Intervalle |
Résultat |
|---|---|
YEAR |
Retourne une valeur d'heure ou datetime qui correspond au nombre d'années spécifié à partir de la valeur d'heure ou datetime. |
QUARTER |
Retourne une valeur d'heure ou datetime qui correspond au nombre de trimestres spécifié à partir de la valeur d'heure ou datetime. |
MONTH |
Retourne une valeur d'heure ou datetime qui correspond au nombre de mois spécifié à partir de la valeur d'heure ou datetime. |
WEEK |
Retourne une valeur d'heure ou datetime qui correspond au nombre de semaines spécifié à partir de la valeur d'heure ou datetime. |
DAY |
Retourne une valeur d'heure ou datetime qui correspond au nombre de jours spécifié à partir de la valeur d'heure ou datetime. |
HOUR |
Retourne une valeur d'heure ou datetime qui correspond au nombre d'heures spécifié à partir de la valeur d'heure ou datetime. |
MINUTE |
Retourne une valeur d'heure ou datetime qui correspond au nombre de minutes spécifié à partir de la valeur d'heure ou datetime. |
SECOND |
Retourne une valeur d'heure ou datetime qui correspond au nombre de secondes spécifié à partir de la valeur d'heure ou datetime. |
Exemple
Formule |
Résultat |
|---|---|
DATEADD(MONTH, 3, #18/08/2009#) |
11/18/2009 |
DATEADD(HOUR, 3, DtId) |
Retourne une valeur d'heure pour chaque instance du champ DtId. Par exemple, si l'heure d'origine est 07:00:01, le résultat est 10:00:01. |
DATEADD(DAY, 365, Sell End Date) |
Retourne une date de fin de ventes pour chaque instance distante de 365 jours de la date de fin de vente d'origine. Par exemple, si la date d'origine est le 18/12/2009, le résultat est 18/12/2010. |
Voir aussi