Fonctions Project pour des champs personnalisés dans le bureau Project

Ces fonctions sont utilisées dans des formules afin de calculer les valeurs des champs personnalisés.

Présentation des fonctions Project

Lorsque vous utilisez Microsoft Project, il se peut que vous deviez utiliser des valeurs ne résidant pas directement dans des champs. Les formules vous permettent d’utiliser des champs afin de créer ces nouvelles valeurs.

L’exemple suivant illustre comment utiliser les formules avec les champs personnalisés :

• Lorsqu’elle est ajoutée à un champ numérique personnalisé, la formule suivante retourne une valeur numérique qui indique le nombre de jours entre la date actuelle et la date de fin des tâches de votre échéancier :

DateDiff("d",NOW(),[Finish])

• Lorsqu’elle est ajoutée à un champ texte personnalisé, la formule suivante renvoie une valeur « Pas de planning de référence », « Budget dépassé de 20 % ou plus » ou « Au-dessous du budget » :

  Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
   The CStr function in the above formula works only if the [Baseline Finish] field is defined.
  

Fonctions de conversion

Asc

Renvoie une donnée de type Entier qui représente le code de caractère correspondant à la première lettre d’une chaîne.

Syntaxe

Asc( chaîne )

chaîne  Toute expression de chaîne valide.

CBool

Force une expression à prendre le type de données Booléen.

Syntaxe

CBool( expression )

expression  Toute chaîne ou expression numérique valide.

CByte

Force une expression à prendre le type de données Octet.

Syntaxe

CByte( expression )

expression  Tout Entier entre 0 et 255.

CCur

Force une expression à prendre le type de données Monnaie.

Syntaxe

CCur( expression )

expression  Toute expression numérique comprise entre -922 337 203 685 477,5808 et 922 337 203 685 477,5807.

CDate

Force une expression à prendre le type de données Date.

Syntaxe

CDate( expression )

expression  Toute expression de date valide.

CDbl

Force une expression à prendre le type de données Double.

Syntaxe

CDbl( expression )

expression  Toute expression numérique entre -1,79769313486232E308 et -4,94065645841247E-324 pour les valeurs négatives ; 4,94065645841247E-324 à 1,79769313486232E308 pour les valeurs positives.

CDec

Force une expression à prendre le type de données Décimal.

Syntaxe

CDec( expression )

expression  Toute expression numérique comprise entre +/-79 228 162 514 264 337 593 543 950 335 pour les nombres à échelle zéro, c’est-à-dire les nombres sans positions décimales. Pour les nombres à 28 positions décimales, la plage est +/-7,9228162514264337593543950335. Le numéro autre que zéro le plus bas autorisé est 0,0000000000000000000000000001.

Chr

Renvoie une donnée de type Chaîne contenant le caractère associé au code de caractère spécifié.

Syntaxe

Chr( code de caractère )

code de caractère  Type de données Long qui identifie un caractère.

CInt

Force une expression à prendre le type de données Entier.

Syntaxe

CInt( expression )

expression  Toute expression numérique comprise entre -32 768 et 32 767 ; les fractions sont arrondies.

CLng

Force une expression à prendre le type de données Long.

Syntaxe

CLng( expression )

expression  Toute expression numérique entre -2 147 483 648 et 2 147 483 647 ; les fractions sont arrondies.

CSng

Force une expression à prendre le type de données Simple.

Syntaxe

CSng( expression )

expression  Toute expression numérique comprise entre -3,402823E38 et -1,401298E-45 pour les valeurs négatives ; 1,401298E-45 et 3,402823E38 pour les valeurs positives.

CStr

Force une expression à prendre le type de données Chaîne.

Syntaxe

CStr( expression )

expression  Toute chaîne ou expression numérique valide.

CVar

Force une expression à prendre le type de données Variante.

Syntaxe

CVar( expression )

expression  Même plage que pour Double en ce qui concerne les expressions numériques. Même plage que pour Chaîne pour les expressions non numériques.

DateSerial

Renvoie une donnée de type Variante (Date) pour une année, un mois ou un jour.

Syntaxe

DateSerial( année, mois, jour )

année  Obligatoire ; Entier. Nombre compris entre 100 et 9999 inclus ou expression numérique.

mois  Obligatoire ; Entier. Toute expression numérique.

jour  Obligatoire ; Entier. Toute expression numérique.

DateValue

Renvoie une donnée de type Variante (Date).

Syntaxe

DateValue( date )

date  Obligatoire ; en principe, expression de chaîne représentant une date comprise entre le 1er janvier 100 et le 31 décembre 9999. Toutefois, date peut également être toute expression représentant une date, une heure, ou les deux, à l’intérieur de cette plage.

Day

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 1 et 31 inclus, représentant le jour du mois.

Syntaxe

Day( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison de ces dernières, capables de représenter une date. Si date contient Null, Null est renvoyée.

Hex

Renvoie une donnée de type Chaîne qui représente la valeur hexadécimale d’un nombre.

Syntaxe

Hex( nombre )

nombre  Obligatoire ; toute chaîne ou expression numérique valide.

Hour

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 23 inclus, représentant l’heure du jour.

Syntaxe

Hour( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

Minute

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 59 inclus, représentant la minute de l’heure.

Syntaxe

Minute( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

Month

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 1 et 12 inclus, représentant le mois de l’année.

Syntaxe

Month( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison des deux, représentant une heure. Si date contient Null, Null est renvoyée.

Oct

Renvoie une donnée de type Variante (Chaîne) qui représente la valeur octale d’un nombre.

Syntaxe

Oct( nombre )

nombre  Obligatoire ; toute chaîne ou expression numérique valide.

ProjDateConv

Convertit une valeur en date.

Syntaxe

ProjDateConv( expression, format de date )

expression  Obligatoire ; Variante. Expression à convertir en date.

format de date  Facultatif ; Long. Le format de date par défaut est pjDateDefault, mais vous pouvez remplacer une des constantes pjDateFormat suivantes (format de date appliqué au 9/30/03 à 12:33 P.M.) :

• pjDateDefault : Format par défaut. Défini sous l’onglet Affichage de la boîte de dialogue Options (menu utils).

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

• pjDate_mm_dd_yy: 9/25/07

• pjDate_mm_dd_yyyy: 9/25/2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

• pjDate_mmmm_dd_yyyy: September 25, 2007

• pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

• pjDate_mmm_dd_yyy: Sep 25, '07

• pjDate_mmmm_dd: September 25

• pjDate_mmm_dd: Sep 25

• pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

• pjDate_ddd_mm_dd_yy: Tue 9/25/07

• pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

• pjDate_ddd_hh_mmAM: Tue 12:33 PM

• pjDate_mm_dd: 9/25

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33 PM

• pjDate_ddd_mmm_dd: Tue Sep 25

• pjDate_ddd_mm_dd: Tue 9/25

• pjDate_ddd_dd: Tue 25

• pjDate_Www_dd: W40/2

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDurConv

Convertit une expression en valeur de durée dans l’intensité d’utilisation spécifiée.

Syntaxe

ProjDurConv( expression, intensitéd'utilisationdurée )

expression  Obligatoire ; Variante. Expression à convertir en durée.

intensitéd'utilisationdurée  Facultatif ; Long. Intensité d’utilisation utilisée pour exprimer la durée. Si intensitéd'utilisationdurée n’est pas spécifié, la valeur par défaut est le type d’intensité d’utilisation spécifié dans l’option Afficher la durée en de l’onglet Prévisions de la boîte de dialogue Options (menu Outils). intensitéd'utilisationdurée peut être l’une des constantes pjFormatUnit suivantes :

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

Second

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 59 inclus, représentant la seconde de la minute.

Syntaxe

Second( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

Str

Renvoie une donnée de type Variante (Chaîne) qui représente un nombre.

Syntaxe

Str( nombre )

nombre  Obligatoire ; type de données Long contenant toute expression numérique valide.

StrConv

Renvoie une donnée de type Variante (Chaîne) convertie comme demandé.

Syntaxe

StrConv( chaîne, conversion, LCID )

chaîne  Obligatoire ; expression de chaîne à convertir.

conversion  Obligatoire ; Entier. Somme des valeurs qui spécifient le type de conversion à effectuer.

LCID  Optionnel; localeID, s’il est différent de l’ID de paramètre local du système. (L’ID de paramètre régional système est la valeur par défaut.)

TimeSerial

Renvoie une donnée de type Variante (Date) contenant l’heure complète (heure, minutes, secondes).

Syntaxe

TimeSerial( heure, minute, seconde )

heure  Obligatoire ; Variante (Entier). Nombre compris entre 0 (12:00 A.M.) et 23 (11:00 P.M.) inclus ou expression numérique.

minute  Obligatoire ; Variante (Entier). Toute expression numérique.

seconde  Obligatoire ; Variante (Entier). Toute expression numérique.

TimeValue

Renvoie une donnée de type Variante (Date) contenant l’heure.

Syntaxe

TimeValue( heure )

heure  Obligatoire ; en principe, expression qui représente une heure comprise entre 0:00:00 et 23:59:59 inclus. Toutefois, heure peut être toute expression qui représente une heure dans cette plage. Si heure contient Null, Null est renvoyée.

Val

Renvoie les nombres contenus dans une chaîne sous forme de valeur numérique de type approprié.

Syntaxe

Val( chaîne )

chaîne  Obligatoire ; toute expression de chaîne valide.

Weekday

Renvoie une donnée de type Variante (Entier) contenant un nombre entier représentant le jour de la semaine.

Syntaxe

Weekday( date [, premierjoursem] )

date  Obligatoire ; Variante, expression numérique, expression de chaîne ou toute combinaison des deux représentant une date. Si date contient Null, Null est renvoyée.

premierjoursem  Facultatif ; constante spécifiant le premier jour de la semaine. Dimanche est le jour par défaut.

Year

Renvoie une donnée de type Variante (Entier) contenant un nombre entier représentant l’année.

Syntaxe

Year( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison de ces dernières, capables de représenter une date. Si date contient Null, Null est renvoyée.

Fonctions Date et Heure

CDate

Force une expression à prendre le type de données Date.

Syntaxe

CDate( expression )

expression  Toute expression de date valide.

Date

Renvoie une donnée de type Variante (Date) contenant la date actuelle du système.

Syntaxe

Date

DateAdd

Renvoie une donnée de type Variante (Date) contenant une date à laquelle l’intervalle de temps spécifié a été ajouté.

Syntaxe

DateAdd( intervalle, nombre, date )

intervalle  Obligatoire ; Expression de chaîne qui est l’intervalle de temps que vous souhaitez ajouter, par exemple « m » ou « j » .

nombre  Obligatoire ; expression numérique qui est le nombre d’intervalles que vous souhaitez ajouter. Peut être positive (pour obtenir des dates futures) ou négative (pour obtenir des dates passées).

date  Obligatoire ; Variante (Date) ou valeur littérale représentant la date à laquelle l’intervalle est ajouté.

DateDiff

Renvoie une donnée de type Variante (Long) indiquant le nombre d’intervalles de temps entre les deux dates spécifiées.

Syntaxe

DateDiff( intervalle, date1, date2[, premierjoursem[, premièresem]] )

intervalle  Obligatoire ; expression de chaîne qui est l’intervalle de temps que vous utilisez pour calculer la différence entre date1 et date2.

date1, date2  Obligatoire ; Variante (Date). Deux dates que vous voulez utiliser pour le calcul.

premierjoursem  Facultatif ; constante spécifiant le premier jour de la semaine. Dimanche est le jour par défaut.

premièresem  Facultatif ; constante spécifiant la première semaine de l’année. Si celle-ci n’est pas spécifiée, la semaine où intervient le 1er janvier sera utilisée par défaut.

DatePart

Renvoie une donnée de type Variante (Entier) contenant la partie spécifiée d’une date donnée.

Syntaxe

DatePart( intervalle, date[,premierjoursem[, premièresem]] )

intervalle  Obligatoire; expression de chaîne qui correspond à l’intervalle de temps que vous souhaitez retourner.

date  Obligatoire ; valeur de Variante (Date) que vous souhaitez évaluer.

premierjoursem  Facultatif ; constante spécifiant le premier jour de la semaine. Dimanche est le jour par défaut.

premièresem  Facultatif ; constante spécifiant la première semaine de l’année. Si celle-ci n’est pas spécifiée, la semaine où intervient le 1er janvier sera utilisée par défaut.

DateSerial

Renvoie une donnée de type Variante (Date) pour une année, un mois ou un jour.

Syntaxe

DateSerial( année, mois, jour )

année  Obligatoire ; Entier. Nombre compris entre 100 et 9999 inclus ou expression numérique.

mois  Obligatoire ; Entier. Toute expression numérique.

jour  Obligatoire ; Entier. Toute expression numérique.

DateValue

Renvoie une donnée de type Variante (Date).

Syntaxe

DateValue( date )

date  Obligatoire ; en principe, expression de chaîne représentant une date comprise entre le 1er janvier 100 et le 31 décembre 9999. Toutefois, date peut également être toute expression représentant une date, une heure, ou les deux, à l’intérieur de cette plage.

Day

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 1 et 31 inclus, représentant le jour du mois.

Syntaxe

Day( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison de ces dernières, capables de représenter une date. Si date contient Null, Null est renvoyée.

Hour

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 23 inclus, représentant l’heure du jour.

Syntaxe

Hour( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

IsDate

Renvoie une valeur de type Boolean indiquant si une expression peut être convertie en date.

Syntaxe

IsDate( expression )

expression  Obligatoire ; toute Variante contenant une expression de date ou une expression de chaîne, reconnaissable comme date ou heure.

Minute

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 59 inclus, représentant la minute de l’heure.

Syntaxe

Minute( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

Month

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 1 et 12 inclus, représentant le mois de l’année.

Syntaxe

Month( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison des deux, représentant une heure. Si date contient Null, Null est renvoyée.

Now

Renvoie une donnée de type Variante (Date) spécifiant la date et l’heure en vigueur en se basant sur celles de l’ordinateur.

Syntaxe

Now

ProjDateAdd

Ajoute une durée à une date pour renvoyer une nouvelle date.

Syntaxe

ProjDateAdd( date, durée, calendrier )

date  Obligatoire ; Variante. Date d’origine à laquelle la durée est ajoutée.

durée  Obligatoire ; Variante. Durée à laquelle ajouter la date.

calendrier  Facultatif ; Chaîne. Calendrier à utiliser pour calculer la nouvelle date. Si calendrier n’est pas spécifié, le calendrier utilisé par défaut sera celui des ressources ou, pour la tâche en cours, le calendrier des tâches ou le calendrier standard s’il n’existe pas de calendrier des tâches. Le calendrier standard sera utilisé pour Project Server, quel que soit le calendrier spécifié dans la chaîne calendrier. Quand vous utilisez cette fonction dans une formule créée dans Project Web App et que vous la comparez avec la même formule créée dans Project Professionnel, procédez à un test afin de vérifier que les résultats sont ceux que vous escomptez.

ProjDateConv

Convertit une valeur en date.

Syntaxe

ProjDateConv( expression, format de date )

expression  Obligatoire ; Variante. Expression à convertir en date.

format de date  Facultatif ; Long. Le format de date par défaut est pjDateDefault, mais vous pouvez remplacer une des constantes pjDateFormat suivantes (format de date appliqué 9/30/03 à 12:33 P.M.) :

• pjDateDefault : Format par défaut. Défini sous l’onglet Affichage de la boîte de dialogue Options (menu utils).

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

• pjDate_mm_dd_yy: 9/25/07

• pjDate_mm_dd_yyyy: 9/25/2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

• pjDate_mmmm_dd_yyyy: September 25, 2007

• pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

• pjDate_mmm_dd_yyy: Sep 25, '07

• pjDate_mmmm_dd: September 25

• pjDate_mmm_dd: Sep 25

• pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

• pjDate_ddd_mm_dd_yy: Tue 9/25/03

• pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

• pjDate_ddd_hh_mmAM: Tue 12:33 PM

• pjDate_mm_dd: 9/25

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33 PM

• pjDate_ddd_mmm_dd: Tue Sep 25

• pjDate_ddd_mm_dd: Tue 9/25

• pjDate_ddd_dd: Tue 25

• pjDate_Www_dd: W40/2

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDateDiff

Renvoie la durée entre deux dates en minutes.

Syntaxe

ProjDateDiff( date1, date2, calendrier )

date1  Obligatoire ; Variante. Date utilisée comme début de la durée.

date2  Obligatoire ; Variante. Date utilisée comme fin de la durée.

calendrier  Facultatif ; Chaîne. Calendrier à utiliser lors du calcul de la durée. Si le calendrier n’est pas spécifié, la valeur par défaut de la ressource actuelle est le calendrier des ressources, ou pour la tâche en cours, le calendrier des tâches (ou le calendrier standard s’il n’y a pas de calendrier de tâches Pour Project Server, le calendrier standard est utilisé, quel que soit le calendrier spécifié dans la chaîne de calendrier . Quand vous utilisez cette fonction dans une formule créée dans Project Web App et que vous la comparez avec la même formule créée dans Project Professionnel, procédez à un test afin de vérifier que les résultats sont ceux que vous escomptez.

ProjDateSub

Renvoie la date qui précède une autre date par une durée spécifiée.

Syntaxe

ProjDateSub( date, durée, calendrier )

date  Obligatoire ; Variante. Date d’origine de laquelle la durée est soustraite.

durée  Obligatoire ; Variante. Durée de laquelle soustraire la date.

calendrier  Facultatif ; Chaîne. Calendrier à utiliser pour calculer la différence de date. Si calendrier n’est pas spécifié, le calendrier utilisé par défaut sera celui des ressources ou, pour la tâche en cours, le calendrier des tâches ou le calendrier standard s’il n’existe pas de calendrier des tâches. Le calendrier standard sera utilisé pour Project Server, quel que soit le calendrier spécifié dans la chaîne calendrier. Quand vous utilisez cette fonction dans une formule créée dans Project Web App et que vous la comparez avec la même formule créée dans Project Professionnel, procédez à un test afin de vérifier que les résultats sont ceux que vous escomptez.

ProjDateValue

Renvoie la valeur de date d’une expression.

Syntaxe

ProjDateValue( expression )

expression  Obligatoire ; Variante. Expression à représenter sous forme de date.

ProjDurConv

Convertit une expression en valeur de durée dans l’intensité d’utilisation spécifiée.

Syntaxe

ProjDurConv( expression, intensitéd'utilisationdurée )

expression  Obligatoire ; Variante. Expression à convertir en durée.

intensitéd'utilisationdurée  Facultatif ; Long. Intensité d’utilisation utilisée pour exprimer la durée. Si intensitéd'utilisationdurée n’est pas spécifié, la valeur par défaut est le type d’intensité d’utilisation spécifié dans l’option Afficher la durée en de l’onglet Prévisions de la boîte de dialogue Options (menu Outils). intensitéd'utilisationdurée peut être l’une des constantes pjFormatUnit suivantes :

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Renvoie le nombre de minutes d’une durée.

Syntaxe

ProjDurValue( durée )

durée  Obligatoire ; Variante. Durée à exprimer en minutes.

Second

Renvoie une donnée de type Variante (Entier) spécifiant un nombre entier compris entre 0 et 59 inclus, représentant la seconde de la minute.

Syntaxe

Second( heure )

heure  Obligatoire ; toute Variante, expression numérique ou expression de chaîne, ou la combinaison des deux, représentant une heure. Si heure contient Null, Null est renvoyée.

Time

Renvoie une donnée de type Variante (Date) indiquant l’heure actuelle du système.

Syntaxe

Time

Timer

Renvoie une donnée de type Chaîne représentant le nombre de secondes écoulées depuis minuit.

Syntaxe

Timer

TimeSerial

Renvoie une donnée de type Variante (Date) contenant l’heure complète (heure, minutes, secondes).

Syntaxe

TimeSerial( heure, minute, seconde )

heure  Obligatoire ; Variante (Entier). Nombre compris entre 0 (12:00 A.M.) et 23 (11:00 P.M.) inclus ou expression numérique.

minute  Obligatoire ; Variante (Entier). Toute expression numérique.

seconde  Obligatoire ; Variante (Entier). Toute expression numérique.

TimeValue

Renvoie une donnée de type Variante (Date) contenant l’heure.

Syntaxe

TimeValue( heure )

heure  Obligatoire ; en principe, expression qui représente une heure comprise entre 0:00:00 et 23:59:59 inclus. Toutefois, heure peut être toute expression qui représente une heure dans cette plage. Si heure contient Null, Null est renvoyée.

Weekday

Renvoie une donnée de type Variante (Entier) contenant un nombre entier représentant le jour de la semaine.

Syntaxe

Weekday( date [, premierjoursem] )

date  Obligatoire ; Variante, expression numérique, expression de chaîne ou toute combinaison des deux représentant une date. Si date contient Null, Null est renvoyée.

premierjoursem  Facultatif ; constante spécifiant le premier jour de la semaine. Dimanche est le jour par défaut.

Year

Renvoie une donnée de type Variante (Entier) contenant un nombre entier représentant l’année.

Syntaxe

Year( date )

date  Obligatoire ; toute Variante, expression numérique, expression de chaîne, ou toute combinaison de ces dernières, capables de représenter une date. Si date contient Null, Null est renvoyée.

Fonctions générales

Choose

Sélectionne et renvoie une valeur dans une liste d’arguments.

Syntaxe

Choose( index, choix-1[, choix-2, ... [, choix-n]] )

index  Obligatoire ; expression numérique qui renvoie une valeur comprise entre 1 et le nombre de choix proposés.

choix  Obligatoire ; expression de type Variante contenant un des choix proposés.

IIf

Renvoie une ou deux parties, selon l’évaluation d’une expression.

Syntaxe

IIf( expression, valeur Vrai, valeur Faux )

expression  Obligatoire ; expression de type Variante que vous souhaitez évaluer.

valeur Vrai  Obligatoire ; valeur ou expression à renvoyer si l’expression correspondante a la valeur Vrai.

valeur Faux  Obligatoire ; valeur ou expression à renvoyer si l’expression correspondante a la valeur Faux.

IsNumeric

Renvoie une donnée de type Booléen indiquant si une expression peut être évaluée en tant que nombre.

Syntaxe

IsNumeric( expression )

expression  Obligatoire; Variante contenant une expression numérique ou de chaîne.

IsNull

Renvoie une valeur de type Booléen qui indique si une expression contient des données non valides (Null).

Syntaxe

IsNull( expression )

expression  Obligatoire ; Variante contenant une expression numérique ou une expression de chaîne.

Switch

Évalue une liste d’expressions et renvoie une valeur Variante ou une expression associée à la première expression de la liste qui a la valeur Vrai.

Syntaxe

Switch( expression1, valeur1[, expression2, valeur2, ... [, expressionn,valeurn]] )

Fonctions mathématiques

Abs

Renvoie une valeur du même type que celle qu’elle reçoit, spécifiant la valeur absolue d’un nombre.

Syntaxe

Abs( nombre )

nombre  Obligatoire ; toute expression numérique valide. Si nombre contient Null, Null est renvoyée ; s’il s’agit d’une variable non initialisée, la valeur zéro est renvoyée.

Atn

Renvoie une donnée de type Double spécifiant l’arctangente d’un nombre.

Syntaxe

Atn( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide.

Cos

Renvoie une donnée de type Double spécifiant le cosinus d’un angle.

Syntaxe

Cos( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide qui exprime un angle en radians.

Exp

Renvoie une donnée de type Double spécifiant e (base des logarithmes népériens) élevé à une puissance.

Syntaxe

Exp( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide.

Fix

Renvoie la partie entière d’un nombre. Si le nombre est négatif, renvoie le premier entier négatif supérieur ou égal au nombre.

Syntaxe

Fix( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide. Si nombre contient Null, Null est renvoyée.

Int

Renvoie la partie entière d’un nombre. Si le nombre est négatif, renvoie le premier entier négatif inférieur ou égal au nombre.

Syntaxe

Int( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide. Si nombre contient Null, Null est renvoyée.

Log

Renvoie une donnée de type Double spécifiant le logarithme népérien d’un nombre.

Syntaxe

Log( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide supérieure ou égale à zéro.

Rnd

Renvoie une donnée de type Single contenant un nombre aléatoire.

Syntaxe

Rnd( nombre )

nombre  Obligatoire ; type de données Single ou toute expression numérique valide.

Sgn

Renvoie une donnée de type Variante (Entier) indiquant le signe d’un nombre.

Syntaxe

Sgn( nombre )

nombre  Obligatoire ; toute expression numérique valide.

Renvoie les valeurs comme suit :

• Si le nombre est supérieur à zéro, Sgn renvoie 1.

• Si le nombre est égal à zéro, Sgn renvoie 0.

• Si le nombre est inférieur à zéro, Sgn renvoie -1.

Sin

Renvoie une donnée de type Double spécifiant le sinus d’un angle.

Syntaxe

Sin( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide qui exprime un angle en radians.

Sqr

Renvoie une donnée de type Double spécifiant la racine carrée d’un nombre.

Syntaxe

Sqr( nombre )

nombre  Obligatoire ; type de données Double ou toute expression numérique valide supérieure ou égale à zéro.

Tan

Renvoie une donnée de type Double spécifiant la tangente d’un angle.

Syntaxe

Tan( nombre )

nombre  Obligatoire ; Double ou toute expression numérique valide exprimant un angle en radians.

Fonctions de texte

Asc

Renvoie une donnée de type Entier qui représente le code de caractère correspondant à la première lettre d’une chaîne.

Syntaxe

Asc( chaîne )

chaîne  Toute expression de chaîne valide.

Chr

Renvoie une donnée de type Chaîne contenant le caractère associé au code de caractère spécifié.

Syntaxe

Chr( code de caractère )

code de caractère  Type de données Long qui identifie un caractère.

Format

Renvoie une donnée de type Variante (Chaîne) contenant une expression mise en forme selon les instructions incluses dans une expression de format.

Syntaxe

Format( expression[, format[, premierjoursem[, premièresem]]] )

expression  Obligatoire ; toute expression valide.

format  Facultatif ; expression de format nommé ou définie par l’utilisateur.

premierjoursem  Facultatif ; type de données Constante spécifiant le premier jour de la semaine.

premièresem  Facultatif ; type de données Constante spécifiant la première semaine de l’année.

Instr

Renvoie une donnée de type Variante (Long) spécifiant la position de la première occurrence d’une chaîne dans une autre chaîne.

Syntaxe

Instr( [début, ]chaîne1, chaîne2[, comparaison] )

début  Facultatif ; expression numérique qui définit la position de départ de chaque recherche. Si elle est omise, la recherche commence à la position du premier caractère. Si début contient Null, une erreur se produit. L’argument début est obligatoire si comparaison est spécifié.

chaîne1  Obligatoire ; expression de chaîne faisant l’objet d’une recherche.

chaîne2  Obligatoire ; expression de chaîne recherchée.

comparaison  Facultatif ; spécifie le type de comparaison de chaîne. Si comparaison a la valeur Null, une erreur se produit. Si comparaison est omis, le paramètre Optioncomparaison détermine le type de comparaison.

LCase

Renvoie une Chaîne convertie en minuscules.

Syntaxe

LCase( chaîne )

chaîne   Obligatoire ; toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.

Left

Renvoie une donnée de type Variante (Chaîne) contenant un nombre défini de caractères du côté gauche d’une chaîne.

Syntaxe

Left( chaîne, longueur )

chaîne  Obligatoire. Expression de chaîne de laquelle les caractères les plus à gauche sont renvoyés. Si chaîne contient Null, Null est renvoyée.

longueur  Obligatoire ; Variante (Long). Expression numérique indiquant le nombre de caractères à renvoyer. Si elle est égale à 0, une chaîne vide ("") est renvoyée. Si elle est supérieure ou égale au nombre de caractères de la chaîne, la chaîne entière est renvoyée.

Len

Renvoie une donnée de type Long contenant le nombre de caractères dans une chaîne ou le nombre d’octets requis pour stocker une variable.

Syntaxe

Len( chaîne, varname )

chaîne  Toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.

varname  Tout nom de variable valide. Si varname contient Null, Null est renvoyé. Si varname est de type Variante, Len la considère comme une Chaîne et renvoie toujours le nombre de caractères qu’elle contient.

LTrim

Renvoie une donnée de type Variante (Chaîne) contenant une copie de la chaîne spécifiée sans espaces d’en-tête.

Syntaxe

LTrim( chaîne )

chaîne  Obligatoire ; toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.

Mid

Renvoie une donnée de type Variante (Chaîne) contenant un nombre défini de caractères d’une chaîne.

Syntaxe

Mid( chaîne, début[, longueur] )

chaîne  Obligatoire ; expression de chaîne à partir desquelles des caractères sont renvoyés. Si chaîne contient Null, Null est renvoyée.

début  Obligatoire ; Long. Position des caractères dans la chaîne où commence la partie à prendre. Si début est supérieur au nombre de caractères de la chaîne, Mid renvoie une chaîne nulle ("").

longueur  Facultatif ; Variante (Long). Nombre de caractères à renvoyer. Si elle est omise ou s’il existe moins de caractères de type longueur dans le texte (notamment le caractère de type début), tous les caractères, de la position début jusqu’à la fin de la chaîne, sont renvoyés.

Right

Renvoie une donnée de type Variante (Chaîne) contenant un nombre défini de caractères du côté droit d’une chaîne.

Syntaxe

Right( chaîne, longueur )

chaîne  Obligatoire ; expression de chaîne de laquelle les caractères les plus à droite sont renvoyés. Si chaîne contient Null, Null est renvoyée.

longueur  Obligatoire ; Variante (Long). Expression numérique indiquant le nombre de caractères à renvoyer. Si elle est égale à 0, une chaîne vide ("") est renvoyée. Si elle est supérieure ou égale au nombre de caractères de la chaîne, la chaîne entière est renvoyée.

RTrim

Renvoie une donnée de type Variante (Chaîne) contenant une copie d’une chaîne définie, sans espaces de fin.

Syntaxe

RTrim( chaîne )

chaîne  Obligatoire ; toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.

Space

Renvoie une donnée de type Variante (Chaîne) qui consiste en un nombre défini d’espaces.

Syntaxe

Space( nombre )

nombre  Obligatoire ; nombre d’espaces souhaité dans la chaîne.

StrComp

Renvoie une donnée de type Variante (Entier) indiquant le résultat d’une comparaison de chaînes.

Syntaxe

StrComp( chaîne1, chaîne2[, comparaison] )

chaîne1  Obligatoire ; toute expression de chaîne valide.

chaîne2  Obligatoire ; toute expression de chaîne valide.

comparaison  Facultatif ; spécifie le type de comparaison de chaînes. Si l’argument comparaison a la valeur Null, une erreur se produit.

StrConv

Renvoie une donnée de type Variante (Chaîne) convertie comme demandé.

Syntaxe

StrConv( chaîne, conversion, LCID )

chaîne  Obligatoire ; expression de chaîne à convertir.

conversion  Obligatoire ; Entier. Somme des valeurs qui spécifient le type de conversion à effectuer.

LCID  Optionnel; localeID, s’il est différent de l’ID de paramètre local du système. (L’ID de paramètre régional système est la valeur par défaut.)

String

Renvoie une donnée de type Variante (Chaîne) contenant une chaîne de caractères extensible de la longueur spécifiée.

Syntaxe

String( nombre, caractère )

nombre  Obligatoire ; Long. Longueur de la chaîne renvoyée. Si nombre contient Null, Null est renvoyée.

caractère  Obligatoire ; Variante. Code de caractère spécifiant le caractère ou l’expression de chaîne dont le premier caractère sert à construire la chaîne à renvoyer. Si caractère contient Null, Null est renvoyée.

Trim

Renvoie une donnée de type Variante (Chaîne) contenant une copie d’une chaîne spécifiée sans espaces d’en-tête ni de fin.

Syntaxe

Trim( chaîne )

chaîne  Obligatoire ; toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.

UCase

Renvoie une donnée de type Variante (Chaîne) contenant la chaîne spécifiée, convertie en majuscules.

Syntaxe

UCase( chaîne )

chaîne  Obligatoire ; toute expression de chaîne valide. Si chaîne contient Null, Null est renvoyée.