Format, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Renvoie une variante (chaîne) contenant un expression mis en forme selon les instructions incluses dans une expression de format.

Voir quelques exemples

Syntaxe

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

La syntaxe de la fonction Format comprend les arguments suivants :

Argument

Description

expression

Obligatoire. Toute expression valide.

mettre en forme

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

premierjoursem

Facultatif. constante qui spécifie le premier jour de la semaine.

premièresem

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


Paramètres

Le formatargument peuvent utiliser une variété de paramètres, selon le type de données de l’argument d’expression . Consultez les articles répertoriés dans le tableau suivant pour plus d’informations sur les expressions de format valide.

Pour les expressions qui utilisent ce type de données...

Consultez l’article

N’importe quel type

Format, propriété

Date/heure

Mettre en forme de Date/heure, propriété - Type de données

Numérique

Format, propriété - Types de données de devise et de nombre

Texte et Mémo

Format, propriété - Types de données Mémo et de texte

Oui/Non

Format, propriété - Type de données Oui/non


L’argument premierjoursem comporte ces paramètres :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

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 premièresem comporte ces paramètres :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

vbFirstJan1

1

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

vbFirstFourDays

2

Précédez la première semaine comportant au moins quatre jours dans l’année.

vbFirstFullWeek

3

Précédez la première semaine complète de l’année.


Notes

Pour mettre en forme

Procédez comme suit

Chiffres

Utilisez des 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 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 heure

Utilisez les formats de date et heure ou des formats numériques.

Chaînes

Créer vos propres formats de chaîne définie par l’utilisateur.


Si vous essayez de mettre en forme un nombre sans le mettre en forme, Format fournit une fonctionnalité similaire à la fonction Str , bien qu’il soit à l’échelle internationale prenant en charge. Toutefois, les nombres positifs mis en forme en tant que chaînes à l’aide du Format ne pas inclure un espace à gauche réservé pour le signe de la valeur ; ceux convertis à l’aide de Str conservent l’espace à gauche.

Si vous mettez en forme 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 obteniez l’aspect souhaité.

Remarque : Si le paramètre de propriété calendrier est grégorien et format Spécifie le format de date, l' expression fournie doit être grégorien. Si le paramètre de propriété Visual Basic calendrier est Hijri, l' expression fournie doit être islamique.

Si le calendrier est grégorien, la signification des symboles de l’expression format reste inchangée. Si le calendrier islamique, tous les symboles de format de date (par exemple, jjjj, mmmm, yyyy) ont la même signification mais s’appliquent au calendrier islamique (Hijri). Symboles de format restent en anglais ; les symboles qui génèrent un affichage du texte (par exemple, AM et PM) affichent la chaîne (anglais ou arabe) associée à ce symbole. La plage de certains symboles changent lorsque le calendrier islamique est utilisé.

Symbole

Plage

j

1-30

jj

1-30

ss

1-51

mmm

Affiche les noms de mois complets (noms des mois Hijri n’ont aucun 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 dans un formulaire ou un état. Les exemples suivants montrent une expression que vous pouvez utiliser dans la propriété de filtre d’un état pour limiter la sortie d’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 nommé Date, qui contient la date de chaque enregistrement particulier a été modifié, et qui est utilisée dans le rapport. Lorsque vous exécutez le rapport, ses résultats sont filtrées pour afficher uniquement les enregistrements où la semaine pour la valeur dans le champ Date (Format([Date],"ww")) est égal à la semaine précédente (Format(Now(),"ww")-1).

Utilisez la fonction Format dans du code VBA   

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’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 recherche et entrez un ou plusieurs termes dans la zone de recherche.

Cet exemple illustre différentes utilisations de la fonction Format pour mettre en forme des valeurs à l’aide de formats nommés et formats définis par l’utilisateur. Pour le séparateur de date (/), séparateur d’heure (:) et AM / PM littéral, la sortie formatée réellement affichée par votre système repose sur les paramètres régionaux de l’ordinateur sur lequel s’exécute le code. Lorsque heures et dates sont affichées dans l’environnement de développement, le format d’heure, abrégé et le format de date courte des paramètres régionaux du code sont utilisés. Lors de l’affichage en exécutant le code, le format d’heure, abrégé et le format de date courte des paramètres régionaux du système sont utilisés, qui peuvent différer de paramètres régionaux de code. Dans cet exemple, l’anglais est supposé égal.

MyTime et MyDate s’affichent dans l’environnement de développement à l’aide du paramètre d’heure, abrégé système actuel et de 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".


À l’aide de Format avec des chaînes vides

Dans Microsoft Access version 2.0 et les versions antérieures, vous pouvez utiliser la fonction Format pour renvoyer une valeur pour une chaîne nulle et une autre pour une valeur. Par exemple, vous pourriez 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 de Microsoft Access 97 et versions ultérieures, vous devez tester séparément le cas Null , puis renvoyer la valeur appropriée en fonction du résultat. Par exemple, vous pouvez utiliser la fonction IIf 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 d’une chaîne de caractères selon qu’il s’agit d’une chaîne de longueur nulle ou une valeur Null. D’autres expressions de format utilisées avec la fonction Format continuent à fonctionner comme dans les versions précédentes.

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

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
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.

×