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 à Date, Time ou à DateTime. La méthode peut ajouter TimeSpan ou Integer afin de représenter une partie de date ou d'heure spécifiée (par exemple, un nombre de jours). Si Si un nombre entier doit être ajouté à une date ou à une part de temps, trois arguments sont utilisés : Arg1 est une chaîne qui décrit la partie à ajouter. Arg2 est un nombre qui contient le nombre de pièces à ajouter. Arg3 est la colonne Les arguments valides pour Arg1 sont : ' ' ' ' ' ' ' ' ' ' ' Exemples :
|
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 ( 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 : ' ' ' ' ' ' ' ' ' ' ' ' ' ' Exemple :
Pour des exemples, consultez Calcul des différences de temps et Calcul des périodes. |
DatePart(Arg1, Arg2)
|
Renvoie une partie spécifiée de Date, Time ou DateTime. Arg1 est une chaîne décrivant la partie de la date à obtenir et Arg2 correspond à la colonne Date, Time ou DateTime. Les données sous-jacentes du calcul sont un entier, mais les paramètres régionaux déterminent les résultats formatés pour certains des arguments ('mm', 'qq', 'dw'). Les arguments valides pour Arg1 sont : ' ' ' ' ' ' ' ' ' ' ' ' ' ' Exemple :
|
DateTimeNow()
|
Renvoie l'heure actuelle du système. Notez que lors de l'exécution de l'expression dans un client Web ou à l'aide des Services d'automatisation, c'est l'heure du fuseau horaire du service (sur le serveur) qui est renvoyée. Exemple :
Pour obtenir des exemples, consultez Calcul des différences de temps et Calcul des périodes. |
Day(Arg1)
|
Extrait le jour du mois d'une colonne Date ou DateTime. Le résultat est un entier compris entre 1 et 31. Exemple :
|
DayOfMonth(Arg1)
|
Extrait le jour du mois d'une colonne Date ou DateTime. Le résultat est un entier compris entre 1 et 31. Exemple :
|
DayOfWeek(Arg1)
|
Extrait le jour de la semaine d’une 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 :
|
DayOfYear(Arg1)
|
Extrait le jour de l'année d'une colonne Date ou DateTime. Renvoie un entier compris entre 1 et 366. Exemple :
|
Days(Arg1)
|
Renvoie le nombre de jours pour un TimeSpan sous la forme d'une valeur entière comprise entre -10675199 et 10675199 ; ou, si l'argument est une valeur Exemples :
|
FiscalMonth(Arg1, Arg2)
|
Renvoie le mois d'exercice d'une date. Le premier argument est la colonne Si aucun second argument n'est spécifié, la valeur de la propriété de document Lorsque vous l'utilisez dans les hiérarchies, la méthode
La hiérarchie dans l'image est construite à l'aide de l'expression suivante :
Examples:
|
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 aucun second argument n'est spécifié, la valeur de la propriété de document Exemples :
|
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 aucun second argument n'est spécifié, la valeur de la propriété de document Exemples :
|
Hour(Arg1)
|
Extrait l'heure de la colonne DateTime ou Time. Renvoie un entier compris entre 0 et 23. Exemple :
|
Hours(Arg1)
|
Renvoie le nombre d’heures pour un TimeSpan sous la forme d'une valeur Integer comprise entre -0 et 23 ; ou, si l'argument est une valeur Exemples :
|
ISOWeek(Arg1)
|
Renvoie la semaine ISO selon la norme ISO 8601 pour une date (Date ou DateTime) sous la forme d’un entier compris entre 1 et 53. Exemple :
|
ISOYear(Arg1)
|
Renvoie l’année avec numérotation des semaine ISO selon la norme ISO 8601 à partir d’une date (Date ou DateTime) sous la forme d’un entier. Exemple :
|
Millisecond(Arg1)
|
Extrait les millisecondes de la colonne DateTime ou Time. Renvoie un entier compris entre 0 et 999. Exemple :
|
Milliseconds(Arg1)
|
Renvoie le nombre de millisecondes pour un TimeSpan sous la forme d'une valeur Integer comprise entre 0 et 999 ou, si l'argument est une valeur Exemples :
|
Minute(Arg1)
|
Extrait les minutes de la colonne DateTime ou Time. Renvoie un entier compris entre 0 et 59. Exemple :
|
Minutes(Arg1)
|
Renvoie le nombre de minutes pour un TimeSpan sous la forme d'une valeur Integer comprise entre 0 et 59 ; ou, si l'argument est une valeur Exemples :
|
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 :
|
Quarter(Arg1)
|
Extrait le trimestre d'une colonne (Date) ou (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 :
|
Second(Arg1)
|
Extrait les secondes d'une colonne DateTime ou Time. Renvoie un entier compris entre 0 et 59. Exemple :
|
Seconds(Arg1)
|
Renvoie le nombre de secondes pour un TimeSpan sous la forme d'une valeur Integer comprise entre 0 et 59 ; ou, si l'argument est une valeur Exemples :
|
Today()
|
Renvoie la date actuelle. Notez que lors de l'exécution de l'expression dans un client Web ou à l'aide des Services d'automatisation, c'est la date du fuseau horaire du service (sur le serveur) qui est renvoyée. Exemple :
|
TotalDays(Arg1)
|
Renvoie le nombre de jours pour TimeSpan sous forme de valeur réelle exprimée en jours complets et fractionnés. Exemple :
|
TotalHours(Arg1)
|
Renvoie le nombre d'heures pour TimeSpan sous forme de valeur réelle exprimée en heures complètes et fractionnées. Exemple :
|
TotalMilliseconds(Arg1)
|
Renvoie le nombre de millisecondes pour TimeSpan sous forme de valeur réelle exprimée en millisecondes complètes et fractionnées. Exemple :
|
TotalMinutes(Arg1)
|
Renvoie le nombre de minutes pour TimeSpan sous forme de valeur réelle exprimée en minutes complètes et fractionnées. Exemple :
|
TotalSeconds()
|
Renvoie le nombre de secondes pour TimeSpan sous forme de valeur réelle exprimée en secondes complètes et fractionnées. Exemple :
|
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 :
|
Year(Arg1)
|
Extrait l'année d'une colonne Date ou DateTime. Le résultat est de type Integer. Exemple :
|
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 :
|
