Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne WordCap(chaîne)
Entrée
Paramètre
chaîne
Description Type
La chaîne qui va être mise en majuscules
Chaîne
Obligatoire
Oui
Exemples
WordCap("Chiffre d'affaires de mars") renvoie "Chiffre D'affaires De Mars".
6.1.3 Fonctions du groupe Date and Time
90
6.1.3.1 CurrentDate
Description
Renvoie la date actuelle au format conforme aux paramètres régionaux
Groupe de fonctions
Date et heure
Syntaxe
date CurrentDate()
Exemples
CurrentDate() renvoie 10 septembre 2002 si la date est le 10 septembre 2002.
6.1.3.2 CurrentTime
Description
Renvoie l'heure actuelle au format conforme aux paramètres régionaux
2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
heure CurrentTime()
Exemples
CurrentTime renvoie 11:15 si l'heure actuelle est 11 h 15.
6.1.3.3 DayName
Description
Renvoie le nom du jour correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne DayName(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayName([Date de réservation]) renvoie "samedi' si [Date de réservation] est 15 décembre
2001 (ce qui correspond à un samedi).
Remarque
La date saisie doit être une variable. Vous ne pouvez pas spécifier directement la date, comme dans
DayName("07/15/2001")
.
6.1.3.4 DayNumberOfMonth
Description
Renvoie le numéro du jour dans un mois
91 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier DayNumberOfMonth(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayNumberOfMonth([Date de réservation]) renvoie 15 si [Date de réservation] est "15 décembre
2001".
6.1.3.5 DayNumberOfWeek
Description
Renvoie le numéro du jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
entier DayNumberOfWeek(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
DayNumberOfWeek([Date de réservation]) renvoie 1 si la date figurant dans [Date de réservation] est le 2 mai 2005 (ce qui correspond à un lundi).
6.1.3.6 DayNumberOfYear
92 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le numéro du jour dans une année
Groupe de fonctions
Date et heure
Syntaxe
entier DayNumberOfYear(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayNumberOfYear([Date de réservation]) renvoie 349 si [Date de réservation] est "15 décembre
2001".
6.1.3.7 DaysBetween
Description
renvoie le nombre de jours compris entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier DaysBetween(première_date;dernière_date)
Entrée
Paramètre
première_date dernière_date
Description
La première date
La dernière date
Type
Date
Date
Obligatoire
Oui
Oui
Exemples
DaysBetween([Date de la vente];[Date de facture]) renvoie 2 si [Date de la vente] correspond au 15 décembre 2001 et [Date de facture] au 17 décembre 2001.
93 2012-05-10
Fonctions, opérateurs et mots clés
6.1.3.8 LastDayOfMonth
Description
Renvoie la date du dernier jour d'un mois
Groupe de fonctions
Date et heure
Syntaxe
date LastDayOfMonth(date)
Entrée
Paramètre
date
Description
N'importe quelle date du mois
Type
Date
Obligatoire
Oui
Exemples
LastDayOfMonth([Date de la vente]) renvoie 31 décembre 2005 si [Date de la vente] correspond au 11 décembre 2005.
6.1.3.9 LastDayOfWeek
Description
Renvoie la date du dernier jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
date LastDayOfWeek(date)
94 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
date
Description Type
N'importe quelle date de la semaine
Date
Obligatoire
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
LastDayOfWeek([Date de la vente]) renvoie 15 mai 2005 (un dimanche) si [Date de la vente] correspond au 11 mai 2005.
6.1.3.10 Month
Description
Renvoie le nom du mois correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne Month(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
Month([Date de réservation]) renvoie "Décembre" si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.1.3.11 MonthNumberOfYear
Description
Renvoie le numéro du mois correspondant à une date
95 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier MonthNumberOfYear(date)
Entrée
Paramètre
date
Description Type
N'importe quelle date de l'année
Date
Obligatoire
Oui
Exemple
MonthNumberOfYear([Date de réservation]) renvoie 12 si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.1.3.12 MonthsBetween
Description
Renvoie le nombre de mois entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier MonthsBetween(première_date;dernière_date)
Entrée
Paramètre
première_date dernière_date
Description
La première date
La dernière date
Type
Date
Date
Obligatoire
Oui
Oui
Exemples
MonthsBetween([Date de la vente];[Date de facture]) renvoie 1 si [Date de la vente] correspond au 2 décembre 2005 et [Date de facture] au 2 janvier 2006.
6.1.3.13 Quarter
96 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le numéro du trimestre correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Quarter(date)
Entrée
Paramètre
date
Description Type
N'importe quelle date du trimestre
Date
Obligatoire
Oui
Exemples
Quarter([Date de réservation]) renvoie 4 si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.1.3.14 DateRelative
Description
Renvoie une date relative à une autre date
Groupe de fonctions
Date et heure
Syntaxe
date DateRelative(date_début;nombre_de_jours)
Entrée
Paramètre
date_début nombre_de_jours
Description
La date de début
Type
Date
Le nombre de jours à partir de la date de début
Nombre
Obligatoire
Oui
Oui
Remarques
Le paramètre nombre_de_jours peut être négatif pour renvoyer une date antérieure à date_début.
97 2012-05-10
Fonctions, opérateurs et mots clés
98
Exemples
DateRelative([Date de réservation];2) renvoie 17 décembre 2005 si [Date de réservation] correspond au 15 décembre 2005;
DateRelative([Date de réservation];-3) renvoie 9 janvier 2007 si [Date de réservation] correspond au 12 janvier 2007.
6.1.3.15 TimeDim
Description
La dimension temporelle TimeDim permet de construire un axe de temps à partir d'un objet d'univers de type Date. TimeDim renvoie les données correspondant aux dates spécifiées en tant que premier paramètre pour les périodes indiquées comme second paramètre. Si certaines périodes ne comprennent aucune donnée, le premier jour de chaque période vide est renvoyé. On dispose ainsi d'un axe complet pour la période donnée. Cela garantit que :
• L'axe conserve l'ordre chronologique naturel (les objets les plus anciens en premier, les plus récents en dernier).
• L'axe contient toutes les périodes situées entre les dates minimum et maximum du contexte actuel.
Groupe de fonctions
Date et heure
Syntaxe
TimeDim([Type de date]; Type de période)
Entrée
Paramètre Description Type
Type de date L'objet de date pour le rapport, InvoiceDate par exemple.
Date
Type de période
La période pour les résultats, à partir des valeurs suivantes :
• DayPeriod
• MonthPeriod
• QuarterPeriod
• YearPeriod
Si aucune valeur n'est sélectionnée, DayPeriod est utilisé par défaut. Cet objet doit être un objet de fournisseur de données disponible à partir des objets de rapport. Il ne peut s'agir d'une variable.
Prédéfini
Obligatoire
Oui
Facultatif
Utilisez la fonction ci-dessus conjointement avec les fonctions suivantes :
2012-05-10
Fonctions, opérateurs et mots clés
• DayName
• DayNumberOfMonth
• DayNumberOfWeek
• DayNumberOfYear
• Month
• MonthNumberOfYear
• Quarter
• Year
• FormatDate
Exemple
Le premier tableau contient les données qui ne concernent que certaines dates. Les exemples de requête suivants montrent comment sont interprétés les résultats.
Date de la facture
1/3/00
1/8/00
7/3/00
Chiffre d'affaires
31 607
31 244
38 154
La formule DayName(TimeDim([Date de la facture] ; QuarterPeriod) renvoie les valeurs journalières du tableau ci-dessus.
Date de la facture
1/3/00
1/8/00
4/1/00
7/3/00
Chiffre d'affaires
31 607
31 244
38 154
Vous devez mettre en forme les résultats de la fonction TimeDim avec la fonction Quarter pour renvoyer les résultats par trimestre (T1, T2, etc.) afin d'obtenir le tableau de résultats suivant :
99 2012-05-10
Fonctions, opérateurs et mots clés
Date de la facture
T1
T2
T3
Chiffre d'affaires
62 851
38 154
6.1.3.16 EnDate
Description
renvoie une chaîne de caractères spécifiant la date indiquée dans le format défini.
Groupe de fonctions
Date et heure
Syntaxe
date EnDate(chaîne_date;format)
Entrée
Paramètre
chaîne_date format
Description
Date à formater
Le format de date
Type
chaîne chaîne
Obligatoire
Oui
Oui
Exemples
EnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
6.1.3.17 Week
Description
Renvoie le numéro de la semaine de l'année
Groupe de fonctions
Date et heure
Syntaxe
entier Week(date)
100 2012-05-10
