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 )

String 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 compris 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 comprise entre -1.79769313486232E308 à -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 à l’échelle zéro, c’est-à-dire les nombres sans 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 )

charcodeLong 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 ; fractions sont arrondies.

CLng

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

Syntaxe

CLng( expression )

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

CSng

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

Syntaxe

CSng( expression )

Expression Toute expression numérique -3.402823E38 à -1.401298E-45 pour les valeurs négatives ; 1.401298E-45 à 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 Double pour les nombres. 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( year, month, day )

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

Retourne un Variant (Date).

Syntaxe

DateValue( date )

Date Obligatoire; normalement une expression de chaîne représentant une date du 1er janvier 100 au 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 ou expression de chaîne, ou toute combinaison, qui peut 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.

Heure

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( time )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter 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( time )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter une heure. Si heure contient Null, Null est renvoyée.

Mois

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 ou expression de chaîne, ou toute combinaison, qui peut représenter 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; Variant. Expression à convertir en date.

Dateformat Optionnel; 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/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; Variant. Expression à convertir en durée.

durationunits Optionnel; 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

Seconde

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( time )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter 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; 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 )

String Obligatoire; expression de chaîne à convertir.

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

LCID Facultatif ; 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( hour, minute, second )

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

Minute Obligatoire; Variant (Entier). Toute expression numérique.

Deuxième Obligatoire; Variant (Entier). Toute expression numérique.

TimeValue

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

Syntaxe

TimeValue( heure )

Temps Obligatoire; normalement une expression de chaîne représentant une heure comprise entre 0:00:00 (12:00:00 A.M.) à 23:59:59 (23:59:59 P.M.), 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 )

String 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; Variant, expression numérique, expression de chaîne de n’importe quelle combinaison, qui peut représenter une date. Si date contient Null, Null est renvoyée.

firstdayofweek Optionnel; constante qui spécifie 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 ou expression de chaîne, ou toute combinaison, qui peut 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 « d ».

Nombre Obligatoire; expression numérique qui correspond au 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; Variant (Date) ou littéral 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; Variant (Date). Deux dates que vous voulez utiliser pour le calcul.

firstdayofweek Optionnel; constante qui spécifie le premier jour de la semaine. Dimanche est le jour par défaut.

firstweekofyear Optionnel; constante qui spécifie 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( interval, date[, firstdayofweek[, firstweekofyear]] )

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.

firstdayofweek Optionnel; constante qui spécifie le premier jour de la semaine. Dimanche est le jour par défaut.

firstweekofyear Optionnel; constante qui spécifie 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( year, month, day )

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

Retourne un Variant (Date).

Syntaxe

DateValue( date )

Date Obligatoire; normalement une expression de chaîne représentant une date du 1er janvier 100 au 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 ou expression de chaîne, ou toute combinaison, qui peut représenter une date. Si date contient Null, Null est renvoyée.

Heure

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( time )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter 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; tout variant contenant une expression de date ou une expression de chaîne reconnaissable en tant que 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 )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter une heure. Si heure contient Null, Null est renvoyée.

Mois

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 ou expression de chaîne, ou toute combinaison, qui peut représenter 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; Variant. Date d’origine à laquelle la durée est ajoutée.

Durée Obligatoire; Variant. Durée à laquelle ajouter la date.

Calendrier Optionnel; 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; Variant. Expression à convertir en date.

Dateformat Optionnel; 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, calendar )

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

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

Calendrier Optionnel; 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; Variant. Date d’origine de laquelle la durée est soustraite.

Durée Obligatoire; Variant. Durée de laquelle soustraire la date.

Calendrier Optionnel; 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; Variant. 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; Variant. Expression à convertir en durée.

durationunits Optionnel; 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( duration )

Durée Obligatoire; Variant. Durée à exprimer en minutes.

Seconde

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( time )

Temps Obligatoire; toute variante, expression numérique ou expression de chaîne, ou toute combinaison, qui peut représenter 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; Variant (Entier). Nombre compris entre 0 (12:00 A.M.) et 23 (11:00 P.M.) inclus ou expression numérique.

Minute Obligatoire; Variant (Entier). Toute expression numérique.

Deuxième Obligatoire; Variant (Entier). Toute expression numérique.

TimeValue

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

Syntaxe

TimeValue( heure )

Temps Obligatoire; normalement une expression de chaîne représentant une heure comprise entre 0:00:00 (12:00:00 A.M.) à 23:59:59 (23:59:59 P.M.), 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; Variant, expression numérique, expression de chaîne de n’importe quelle combinaison, qui peut représenter une date. Si date contient Null, Null est renvoyée.

firstdayofweek Optionnel; constante qui spécifie 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 ou expression de chaîne, ou toute combinaison, qui peut représenter une date. Si date contient Null, Null est renvoyée.

Fonctions générales

Choisir

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 ou champ qui aboutit à une valeur comprise entre 1 et le nombre de choix disponibles.

Choix Obligatoire; Expression variant contenant l’un des choix possibles.

IIf

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

Syntaxe

IIf( expression, valeur Vrai, valeur Faux )

Expr Obligatoire; Expression variant que vous souhaitez évaluer.

truepart Obligatoire; value ou expression à retourner si l’expression correspondante a la valeur True.

falsepart Obligatoire; value ou expression à retourner si l’expression correspondante est False.

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; Variant contenant une expression numérique ou une expression 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; Variant 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; 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; 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; 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; 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; 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; Double ou toute expression numérique valide supérieure à zéro.

Rnd

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

Syntaxe

Rnd( nombre )

Nombre Obligatoire; Expression numérique unique ou 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; 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; Double ou toute expression numérique valide égale ou supérieure à 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 qui exprime 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 )

String 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 )

charcodeLong 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 Optionnel; expression de format nommée ou définie par l’utilisateur valide.

firstdayofweek Optionnel; Constante qui spécifie le premier jour de la semaine.

firstweekofyear Optionnel; Constante qui spécifie 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] )

Commencer Optionnel; 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é.

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

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

Comparer Optionnel; spécifie le type de comparaison de chaînes. Si comparaison a la valeur Null, une erreur se produit. Si compare est omis, le paramètre Option compare détermine le type de comparaison.

LCase

Renvoie une Chaîne convertie en minuscules.

Syntaxe

LCase( chaîne )

String 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 )

String 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; Variant (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 )

String 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 )

String 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] )

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

Commencer 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 Optionnel; Variant (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 )

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

Longueur Obligatoire; Variant (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 )

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

Barre d'espace

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és 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] )

string1 Obligatoire; toute expression de chaîne valide.

string2 Obligatoire; toute expression de chaîne valide.

Comparer Optionnel; 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 )

String Obligatoire; expression de chaîne à convertir.

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

LCID Facultatif ; 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.

personnage Obligatoire; Variant. 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 )

String 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 )

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