Passer directement au contenu principal

Format, fonction

Renvoie une valeur de type variante (chaîne) contenant une expression mise en forme conformément aux instructions contenues dans une expression de format.

Avertissement    Il y a un problème avec l’utilisation de cette fonction. Le dernier lundi de certaines années civiles peut être renvoyé comme semaine 53 alors qu’il devrait être semaine 1. Pour plus d’informations et une solution de contournement, voir les fonctions format ou PartDate peuvent renvoyer un numéro de semaine incorrect pour le dernier lundi de l’année.

Voir quelques exemples

Syntaxe

Format ( expression [, format ] [, FirstDayOfWeek ] [, FirstWeekOfYear ] )

La syntaxe de la fonction format comporte les arguments suivants :

Argument

Description

expression

Obligatoire. Toute expression valide.

format

Facultatif. Expression de format nommé ou définie par l’utilisateur valide.

premierjoursem

Facultatif. constante spécifiant le premier jour de la semaine.

premièresem

Facultatif. Constante spécifiant la première semaine de l’année.


Paramètres

L’argument format peut utiliser plusieurs paramètres, en fonction du type de données de l’argument expression . Pour plus d’informations sur les expressions de format valides, voir les articles indiqués dans le tableau ci-dessous.

Pour les expressions utilisant ce type de données...

Voir l’article

Tout type

Propriété Format

Date/heure

Mettre en forme un champ de date et d’heure

Numérique

Mettre en forme un champ numérique ou monétaire

Texte et mémo

Mettre en forme un champ de texte

Oui/Non

Format, propriété - Type de données Yes/No


L’argument FirstDayOfWeek comporte les paramètres suivants :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre d’API NLS.

VbSunday

1

Dimanche (par défaut)

vbMonday

2

Lundi

vbTuesday

3

Mardi

vbWednesday

4

Mercredi

vbThursday

5

Jeudi

vbFriday

6

Vendredi

vbSaturday

7

Samedi


L’argument FirstWeekOfYear peut avoir les valeurs suivantes :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre d’API NLS.

vbFirstJan1

1

Commencer par la semaine du 1er janvier (par défaut).

vbFirstFourDays

2

Commencer la première semaine ayant au moins quatre jours dans l’année.

vbFirstFullWeek

3

Commencer la première semaine complète de l’année


Remarques

Pour mettre en forme

Procédez comme suit

Chiffres

Utilisez les formats numériques nommés prédéfinis ou créez des formats numériques définis par l’utilisateur.

Dates et heures

Utilisez les formats de date/heure de nom nommés prédéfinis ou créez des formats de date/heure définis par l’utilisateur.

Numéros de série de date et d’heure

Utiliser des formats de date et d’heure ou des formats numériques.

String

Créez vos propres formats de chaîne définis par l’utilisateur.


Si vous essayez de mettre en forme un nombre sans spécifier le format, le format fournit des fonctionnalités similaires à la fonction Str , bien qu’il soit compatible avec les plus internationales. Toutefois, les nombres positifs mis en forme en tant que chaînes à l’aide du format ne comprennent pas d’espace de début réservé au signe de la valeur ; les personnes converties en utilisant Str conservent l’espace à gauche.

Si vous effectuez une mise en forme d’une chaîne numérique non localisée, vous devez utiliser un format numérique défini par l’utilisateur pour vous assurer que vous obtenez l’interface souhaitée.

Remarque : Si le paramètre de la propriété calendrier est grégorien et que le format spécifie la mise en forme des dates, l' expression fournie doit être grégorienne. Si la valeur de la propriété calendrier Visual Basic est Hijri, l' expression fournie doit être Hijri.

Si le calendrier est grégorien, la signification des symboles d’expression de format n’est pas modifiée. S’il s’agit du calendrier islamique, tous les symboles de format de date (par exemple, dddd, mmmm, yyyy) ont la même signification mais s’appliquent au calendrier islamique. Les symboles de mise en forme restent en anglais ; les symboles qui génèrent l’affichage du texte (par exemple, AM et PM) affichent la chaîne (English ou arabe) associée à ce symbole. La plage de certains symboles change lorsque le calendrier est Hijri.

Symbole

Plage

j

1-30

jj

1-30

ss

1-51

mmm

Affiche le nom du mois complet (les noms des mois Hijri n’ont pas d’abréviations).

y

1-355

aaaa

100-9666

Exemples

Utiliser la fonction format dans une expression    Vous pouvez utiliser la mise en forme à l’endroit où vous pouvez utiliser des expressions. Par exemple, vous pouvez l’utiliser dans une requête dans le cadre d’un alias de champ ou dans la propriété source contrôle d’une zone de texte d’un formulaire ou d’un État. Les exemples suivants montrent une expression que vous pouvez utiliser dans la propriété filtre d’un rapport afin de limiter la sortie aux enregistrements de la semaine précédente.

Format ([date], "SS") = format (maintenant (), "SS")-1

Dans cet exemple, la source d’enregistrement du rapport comporte un champ intitulé date qui contient la date de modification de chaque enregistrement particulier et celle utilisée dans le rapport. Lorsque vous exécutez le rapport, ses résultats sont filtrés pour afficher uniquement les enregistrements pour lesquels la semaine de la valeur dans le champ de date (format ([date], "SS")) est égale à la semaine précédente (format (maintenant (), "SS")-1).

Utiliser la fonction format dans du code VBA    

Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de Rechercher , puis entrez une ou plusieurs conditions dans la zone de recherche.

Cet exemple illustre différentes utilisations de la fonction format pour mettre en forme les valeurs à l’aide des formats nommés et des formats définis par l’utilisateur. Pour le séparateur de date (/), le séparateur d’heure (:) et le littéral AM/PM, la sortie mise en forme réelle affichée par votre système dépend des paramètres régionaux de l’ordinateur sur lequel le code est exécuté. Lorsque des heures et des dates sont affichées dans l’environnement de développement, le format d’heure courte et le format de date courte des paramètres régionaux du code sont utilisés. Lorsqu’elle est affichée à l’aide de code, le format d’heure courte et le format de date courte des paramètres régionaux du système sont utilisés, qui peuvent être différents des paramètres régionaux du code. Pour cet exemple, les paramètres régionaux Anglais U.S. sont supposés.

MyTime et MyDate sont affichés dans l’environnement de développement à l’aide du paramètre d’heure courte du système actuel et du paramètre date courte.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s") ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM") ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy") ' Returns "Wednesday,
' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23) ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00") ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00") ' Returns "334.90".
MyStr = Format(5, "0.00%") ' Returns "500.00%".
MyStr = Format("HELLO", "<") ' Returns "hello".
MyStr = Format("This is it", ">") ' Returns "THIS IS IT".


Utiliser la mise en forme avec des chaînes vides

Dans la version 2,0 et les versions antérieures de Microsoft Access, vous pouvez utiliser la fonction format pour renvoyer une valeur pour une chaîne nulle et une autre pour une valeur. Par exemple, vous pouvez utiliser une expression de format telle que la suivante avec la fonction format pour renvoyer la valeur de chaîne appropriée à partir du code :

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

Dans les versions 97 et ultérieures de Microsoft Access, vous devez tester séparément la casse null , puis renvoyer la valeur appropriée en fonction du résultat. Par exemple, vous pouvez utiliser la fonction VraiFaux dans une expression avec la fonction format comme suit :

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Cette modification s’applique uniquement lorsque vous utilisez la fonction format pour mettre en forme une chaîne selon qu’il s’agit d’une chaîne de longueur nulle ou d’une valeur de type NULL. D’autres expressions de mise en forme utilisées avec la fonction format continuent de fonctionner comme dans les versions précédentes.

Si vous convertissez une base de données à partir de la version 2,0 et antérieure vers Microsoft Access 2002 ou version ultérieure, vous devez modifier le code pour tester séparément le cas de la valeur null.

Voir aussi

Fonctions de chaîne et comment les utiliser

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.

×