Fonctions de date et d'heure

La liste ci-dessous affiche les fonctions de date et heure pouvant être utilisées dans des expressions.

Fonction	Description
`DateAdd(Arg1, Arg2, Arg3)`	Ajoute un intervalle à une fonction`Date`,`Time` ou`DateTime`. Cette méthode permet d'ajouter une période(`TimeSpan`) ou un nombre entier(`Integer`) représentant une période donnée (un nombre de jours, par exemple). Si un`TimeSpan` doit être ajouté, deux arguments sont nécessaires : une colonne`DateTime` et une colonne`TimeSpan`. Si une valeur entière doit être ajoutée à une partie de date ou d'heure, trois arguments sont utilisés : `Arg1` est une chaîne décrivant la partie à ajouter. `Arg2` est un nombre qui contient le nombre de pièces à ajouter. `Arg3` est la colonne `Date`, `Time` ou `DateTime`. Les arguments valides pour`Arg1` sont : « `year` » ou « `yy` » - L'année. « `quarter` » ou « `qq` » - Le trimestre. « `month` » ou « `mm` » - Le mois. « `day` » ou « `dd` » - Le jour. « `week` » ou « `wk` » - La semaine. « `hour` » ou « `hh` » - L'heure. « `minute` » ou « `mi` » - La minute. « `second` » ou « `ss` » - La seconde. « `millisecond` » ou « `ms` » - La milliseconde. Exemples : `DateAdd([Date Column], [TimeSpan Column])` `DateAdd('year', 2, [Date Column])` `DateAdd('month', 1, [Date Column])`
`DateDiff(Arg1, Arg2, Arg3)`	Calcule la différence entre deux colonnes`Date`,`Time` ou`DateTime`. Le résultat est présenté sous forme de période(`TimeSpan`) ou de valeur réelle représentant une période donnée (un nombre de jours, par exemple). Si deux arguments sont utilisés (une colonne de date de départ et une colonne de date d'arrêt, par exemple), le résultat prend la forme d'une période(`TimeSpan`) correspondant à la différence totale. En cas d'utilisation de trois arguments, le premier d'entre eux correspond à la partie à comparer. Le second argument est la colonne de la date de début et le troisième la colonne de la date de fin. Le résultat de l'opération correspond à une valeur réelle. Les arguments valides pour`Arg1` sont : « `year` » ou « `yy` » - L'année. « `quarter` » ou « `qq` » - Le trimestre. « `month` » ou « `mm` » - Le mois. « `day` » ou « `dd` » - Le jour. « `week` » ou « `wk` » - La semaine. « `hour` » ou « `hh` » - L'heure. « `minute` » ou « `mi` » - La minute. « `second` » ou « `ss` » - La seconde. « `millisecond` » ou « `ms` » - La milliseconde. Exemple : `DateDiff([Order Date], [Delivery Date])` `DateDiff('day', [Order Date], [Delivery Date])` Pour obtenir des exemples, consultez Calcul des différences de temps et Calcul des périodes.
`DatePart(Arg1, Arg2)`	Renvoie une partie spécifiée de la colonne`Date`,`Time` ou`DateTime`.`Arg1` est une chaîne décrivant la partie de la date à sélectionner et`Arg2` est la colonne`Date`,`Time` ou`DateTime`. Les arguments valides pour`Arg1` sont : « `year` » ou « `yy` » - L'année. « `quarter` » ou « `qq` » - Le trimestre. « `month` » ou « `mm` » - Le mois. « `day of year` » ou « `dy` » - Le jour de l'année. « `day` » ou « `dd` » - Le jour. « `year and week` » ou « `yywk` » - L'année et la semaine. « `week` » ou « `wk` » - La semaine. « `day of week` » ou « `dw` » - Le jour de la semaine. « `hour` » ou « `hh` » - L'heure. « `minute` » ou « `mi` » - La minute. « `second` » ou « `ss` » - La seconde. « `millisecond` » ou « `ms` » - La milliseconde. Exemple : `DatePart('year', [Date Column])`
`DateTimeNow()`	Renvoie l'heure actuelle du système. Exemple : `DateTimeNow()` Pour obtenir des exemples, consultez Calcul des différences de temps et Calcul des périodes.
`Day(Arg1)`	Extrait le jour du mois de la colonne`Date` ou`DateTime`. Le résultat est un entier compris entre 1 et 31. Exemple : `Day([Date Column])`
`DayOfMonth(Arg1)`	Extrait le jour du mois de la colonne`Date` ou`DateTime`. Le résultat est un entier compris entre 1 et 31. Exemple : `DayOfMonth([Date Column])`
`DayOfWeek(Arg1)`	Extrait le jour de la semaine de la colonne`Date` ou`DateTime`. La donnée sous-jacente de la nouvelle colonne est un nombre entier compris entre 0 (dimanche) et 6 (samedi), mais les paramètres régionaux déterminent le début de la semaine, ainsi que le format de sortie. Exemple : `DayOfWeek([Date Column])`
`DayOfYear(Arg1)`	Extrait le jour de l'année de la colonne`Date` ou`DateTime`. Renvoie un entier compris entre 1 et 366. Exemple : `DayOfYear([Date Column])`
`Days(Arg1)`	Renvoie le nombre de jours d'une période`TimeSpan` sous forme de`Integer` compris entre -10675199 et 10675199 ou, si l'argument est un`Integer`, crée une colonne`TimeSpan` dont les valeurs sont exprimées en nombre de jours. Exemples : `Days([TimeSpan Column])` `Days(3)`
`FiscalMonth(Arg1, Arg2)`	Renvoie le mois d'exercice d'une date. Le premier argument est la colonne`Date`. Le deuxième argument (facultatif) correspond au nombre de mois à décaler. Si cet argument n'a pas été défini, la valeur`FiscalYearOffset` de la propriété du document est utilisée. Les paramètres régionaux déterminent le format de sortie. Lorsque vous l'utilisez dans les hiérarchies, la méthode`FiscalMonth` assure le suivi de l'ordre de tri des mois, ce qui permet d'afficher les éléments de visualisation dans le bon ordre. Par exemple, si l'exercice se termine en janvier, l'exercice suivant doit commencer en février, comme indiqué ci-dessous, et non en janvier : La hiérarchie dans l'image est créée avec l'expression suivante : `<FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)>` Exemples : `FiscalMonth([Date Column], 1)` `FiscalMonth([Date Column])`
`FiscalQuarter (Arg1, Arg2)`	Renvoie le trimestre d'exercice d'une date (`Arg1`) basé sur un décalage indiqué en mois (`Arg2`). Le deuxième argument est facultatif. Si cet argument n'a pas été défini, la valeur`FiscalYearOffset` de la propriété du document est utilisée. Exemples : `FiscalQuarter([Date Column], 1)` `FiscalQuarter([Date Column])`
`FiscalYear (Arg1, Arg2)`	Renvoie l'exercice d'une date (`Arg1`) basé sur un décalage indiqué en mois (`Arg2`). Le deuxième argument est facultatif. Si cet argument n'a pas été défini, la valeur`FiscalYearOffset` de la propriété du document est utilisée. Exemples : `FiscalYear([Date Column], 1)` `FiscalYear([Date Column])`
`Hour(Arg1)`	Extrait l'heure de la colonne`DateTime` ou`Time`. Renvoie un entier compris entre 0 et 23. Exemple : `Hour([Time Column])`
`Hours(Arg1)`	Renvoie le nombre d'heures d'une période`TimeSpan` sous forme de`Integer` compris entre 0 et 23 ou, si l'argument est un`Integer`, crée une colonne`TimeSpan` dont les valeurs sont exprimées en nombre d'heures. Exemples : `Hours([TimeSpan Column])` `Hours(10)`
`Millisecond(Arg1)`	Extrait les millisecondes de la colonne`DateTime` ou`Time`. Renvoie un entier compris entre 0 et 999. Exemple : `Millisecond([Time Column])`
`Milliseconds(Arg1)`	Renvoie le nombre de millisecondes d'une période`TimeSpan` sous forme de valeur`Real` comprise entre 0.0 et 999.0 ou, si l'argument est une valeur`Real`, crée une colonne`TimeSpan` dont les valeurs sont exprimées en nombre de millisecondes. Exemples : `Milliseconds([TimeSpan Column])` `Milliseconds(123.45)`
`Minute(Arg1)`	Extrait les minutes de la colonne`DateTime` ou`Time`. Renvoie un entier compris entre 0 et 59. Exemple : `Minute([Time Column])`
`Minutes(Arg1)`	Renvoie le nombre de minutes d'une période`TimeSpan` sous forme de`Integer` compris entre 0 et 59 ou, si l'argument est un`Integer`, crée une colonne`TimeSpan` dont les valeurs sont exprimées en nombre de minutes. Exemples : `Minutes([TimeSpan Column])` `Minutes(50)`
`Month(Arg1)`	Extrait le mois d'une colonne`Date` ou`DateTime`. La donnée sous-jacente de la nouvelle colonne est un entier entre 1 et 12, mais des paramètres régionaux déterminent le format de sortie. Exemple : `Month([Date Column])`
`Quarter(Arg1)`	Extrait le trimestre d'une colonne de date (`Date`) ou de période (`DateTime`). La donnée sous-jacente de la nouvelle colonne est un entier entre 1 et 4, mais des paramètres régionaux déterminent le format de sortie. Exemple : `Quarter([Date Column])`
`Second(Arg1)`	Extrait les secondes d'une colonne`DateTime` ou`Time`. Renvoie un entier compris entre 0 et 59. Exemple : `Second([Time Column])`
`Seconds(Arg1)`	Renvoie le nombre de secondes d'une période`TimeSpan` sous forme de`Integer` compris entre 0 et 59 ou, si l'argument est un`Integer`, crée une colonne`TimeSpan` dont les valeurs sont exprimées en nombre de secondes. Exemples : `Seconds([TimeSpan Column])` `Seconds(10)`
`Today()`	Renvoie la date actuelle. Exemple : `Today()`
`TotalDays(Arg1)`	Renvoie le nombre de jours pour une période`TimeSpan` sous forme de valeur réelle exprimée en jours complets et fractionnés. Exemple : `TotalDays([TimeSpan Column])`
`TotalHours(Arg1)`	Renvoie le nombre d'heures pour une période`TimeSpan` sous forme de valeur réelle exprimée en heures complètes et fractionnées. Exemple : `TotalHours([TimeSpan Column])`
`TotalMilliseconds(Arg1)`	Renvoie le nombre de millisecondes pour une période`TimeSpan` sous forme de valeur réelle exprimée en millisecondes complètes et fractionnées. Exemple : `TotalMilliseconds([TimeSpan Column])`
`TotalMinutes(Arg1)`	Renvoie le nombre de minutes pour une période`TimeSpan` sous forme de valeur réelle exprimée en minutes complètes et fractionnées. Exemple : `TotalMinutes([TimeSpan Column])`
`TotalSeconds()`	Renvoie le nombre de secondes pour une période`TimeSpan` sous forme de valeur réelle exprimée en secondes complètes et fractionnées. Exemple : `TotalSeconds([TimeSpan Column])`
`Week(Arg1)`	Extrait la semaine de la colonne`Date` ou`DateTime` sous forme de nombre entier compris entre 1 et 54, la première semaine de l'année dépendant des paramètres régionaux. Exemple : `Week([Date Column])`
`Year(Arg1)`	Extrait l'année d'une colonne`Date` ou`DateTime`. Le résultat est de type`Integer`. Exemple : `Year([Date Column])`
`YearAndWeek(Arg1)`	Extrait l'année et la semaine d'une colonne`Date` ou`DateTime`. Renvoie une valeur`Integer` (Année*100 + Numéro de la semaine). Par exemple, la date 13-10-2005 renverra 200541. Exemple : `YearAndWeek([Date Column])`

Voir aussi Fonctions.

Table des matières

Index

Recherche

Fonctions de date et d'heure