Langage de programmation - Visual Basic (VB) - Référence de procédures et de fonctions

FORMAT	Format
Visual Basic

Syntaxe

Function FORMAT(Expression As String, Format As String, Optional ByVal FirstDayOfWeek As VbDayOfWeek = vbSunday, Optional ByVal FirstWeekOfYear As VbFirstWeekOfYear = vbFirstJan1) As String

Paramètres

Nom	Description
Expression	Ce paramètre permet d'indiquer l'expression à traiter
Format	Ce paramètre permet d'indiquer le format à appliquer à l'expression avec les combinaisons suivantes :
	Caractère	Description
	.	Ce caractère est utilisé pour indiquer un séparateur de décimal pour un nombre
	,	Ce caractère est utilisé pour indiquer un séparateur de millier pour un nombre
	#	Ce caractère est utilisé pour définir chacune des positions d'un nombre
	0	Ce caractère est utilisé pour indiquer que le chiffre sortir obligatoirement à cette position même si le chiffre est inférieur au format
	<	Ce caractère est utilisé d'indiquer que les caractères seront sortie en minuscule
	>	Ce caractère est utilisé d'indiquer que les caractères seront sortie en majuscule
	AMPM	Ces caractères sont utilisés pour indiquer un format d'heure AM/PM
	d	Ce caractère est utilisé pour indiquer le jour du mois
	ddd	Ces caractères sont utilisés pour indiquer le jour de semaine sous forme de mot abrégé de 3 lettres
	dddd	Ces caractères sont utilisés pour indiquer le jour de semaine sous forme de mot
	h	Ce caractère est utilisé pour indiquer les heures en format simple sans ajout de 0 pour combler la longueur
	hh	Ce caractère est utilisé pour indiquer les heures avec ajout de 0 pour combler la longueur
	m	Ce caractère est utilisé pour indiquer les minutes
	mm	Ce caractère est utilisé pour indiquer les minutes avec ajout de 0 pour combler la longueur
	mmm	Ces caractères sont utilisés pour indiquer le mois de l'année sous forme de mot abrégé de 3 lettres
	s	Ce caractère est utilisé pour indiquer les secondes
	ss	Ce caractère est utilisé pour indiquer les secondes avec ajout de 0 pour combler la longueur
	yyyy	Ce caractère est utilisé pour indiquer l'année sous forme de 4 chiffres
FirstDayOfWeek	Ce paramètre permet d'indiquer le premier jour de la semaine :
	Valeur	Constante	Description
	1	vbSunday	Cette valeur indique le Dimanche
	2	vbMonday	Cette valeur indique le Lundi
	3	vbTuesday	Cette valeur indique le Mardi
	4	vbWednesday	Cette valeur indique le Mercredi
	5	vbThursday	Cette valeur indique le Jeudi
	6	vbFriday	Cette valeur indique le Vendredi
	7	vbSaturday	Cette valeur indique le Samedi
FirstWeekOfYear	Ce paramètre permet d'indiquer le première semaine de l'année :
	Valeur	Constante	Description
	1	vbFirstJan1	Cette valeur indique le premier janvier
	2	vbFirstFourDays	Cette valeur indique les premiers 4 jours
	3	vbFirstFullWeek	Cette valeur indique le premier semaine complète

Description

Cette fonction permet d'effectuer une transformation sur des nombres de façon à retourne une chaîne de caractères avec un certain format.

Remarques

La fonction FORMAT est extrêmement puissante pour présenter les données de manière lisible et cohérente. Elle permet de convertir des dates, des heures, des nombres ou du texte en chaînes structurées, ce qui est particulièrement utile pour l'affichage dans des interfaces ou des rapports.
Grâce aux modificateurs de format numériques tels que #, 0, , et ., on peut définir très précisément la manière dont les nombres sont affichés, que ce soit pour imposer un nombre minimum de chiffres, ajouter des zéros non significatifs, ou encore insérer des séparateurs de milliers.
Pour les formats de date et d'heure, les combinaisons comme dddd, mmm, hh, ss,..., offrent un contrôle total sur la mise en forme temporelle. Cela permet par exemple d'obtenir facilement une date dans le style "Lundi 1 janvier 2025" ou une heure comme "09:05:07".
L'utilisation de AMPM dans le format permet de convertir automatiquement une heure en format 12 heures, avec indication "AM" ou "PM", ce qui est essentiel pour l'internationalisation ou les contextes utilisateurs anglo-saxons.
La fonction prend en charge deux paramètres optionnels (FirstDayOfWeek et FirstWeekOfYear) qui permettent de personnaliser le comportement des formats temporels, notamment pour les semaines, selon des standards culturels ou professionnels spécifiques.
FORMAT ne se contente pas de formater des dates ou des nombres ; il est également capable de manipuler les chaînes de caractères, notamment avec les indicateurs > et < pour forcer la casse en majuscule ou minuscule, ce qui est pratique pour homogénéiser des saisies utilisateur.
L'utilisation de FORMAT est souvent préférable aux conversions manuelles ou aux concaténations artisanales, car elle réduit le code, évite les erreurs et garantit des résultats constants, même avec des données mal formatées en entrée.
Bien que très utile, la fonction FORMAT peut devenir complexe à utiliser lorsqu'on enchaîne plusieurs indicateurs ou qu'on souhaite localiser les formats. Il est recommandé de tester ses masques dans un environnement contrôlé avant de les appliquer à grande échelle dans une application.

Dernière mise à jour : Lundi, le 19 novembre 2012

Section courante

A propos

Section administrative du site

FORMAT

Syntaxe

Paramètres

Description

Remarques