Fonctions Project

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

Conseil : Pour entrer une formule dans un champ personnalisé pour Project 2007, dans le menu Outils, pointez sur Personnaliser, puis cliquez sur Champs. Dans la boîte de dialogue Champs personnalisés, cliquez sur Formule. Pour Project 2010, cliquez sur l’onglet Projet, puis, dans le groupe Propriétés, cliquez sur Champs personnalisés. Dans la boîte de dialogue Champs personnalisés, cliquez sur Formule.

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, une 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 ou expression de chaîne, ou la combinaison des deux, représentant une date. 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 Facultatif ; LocaleID, si différente de celle du système (cette dernière est utilisée 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 ; Entier. Expression de chaîne qui est l’intervalle de temps que vous souhaitez renvoyer.

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.

Remarque :  Pour soustraire sept jours d’une date spécifiée, la formule suivante fonctionne correctement dans Project Professionnel 2010 : ProjDateAdd("24/9/2010", "-7j"). Cependant, lorsque vous exécutez la même formule dans Project Server 2010, le résultat est 24/9/2010, pas 17/9/2010. Pour obtenir des formules qui fonctionnent de manière cohérente sur Project Professionnel 2010 et Project Server 2010, évitez les paramètres négatifs pour les fonctions ProjDateAdd et ProjDateSub.

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 pour calculer la durée. 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.

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.

Remarque :  Pour soustraire sept jours d’une date spécifiée, la formule suivante fonctionne correctement dans Project Professionnel 2010 : ProjDateAdd("24/9/2010", "-7j"). Cependant, lorsque vous exécutez la même formule dans Project Server 2010, le résultat est 24/9/2010, pas 17/9/2010. Pour obtenir des formules qui fonctionnent de manière cohérente sur Project Professionnel 2010 et Project Server 2010, évitez les paramètres négatifs pour les fonctions ProjDateAdd et ProjDateSub.

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 combien 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 Facultatif ; LocaleID, si différente de celle du système (cette dernière est utilisée 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.

Développez vos compétences dans Office
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×