FORMAT |
Format |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| Format(expression, [format, [firstdayofweek, [firstweekofyear] ] ] ) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| expression | Ce paramètre permet d'indiquer l'expression à traiter | ||
| format | Ce paramètre permet d'indiquer le format à retourner : | ||
| Valeur | Description | ||
| "General Date" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements du système. | ||
| "Long Date" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de date long du système | ||
| "Medium Date" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de date normal du système | ||
| "Short Date" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de date courte du système | ||
| "Long Time" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de l'heure longue du système | ||
| "Medium Time" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de l'heure normal du système | ||
| "Short Time" | Cette valeur permet d'indiquer qu'il faut retourner une date basé sur les ajustements de l'heure courte du système | ||
| "General Number" | Cette valeur permet d'indiquer qu'il faut retourner un nombre de format général. | ||
| "Currency" | Cette valeur permet d'indiquer qu'il faut retourner une valeur monétaire. | ||
| "Euro" | Cette valeur permet d'indiquer qu'il faut retourner une valeur en Euro. | ||
| "Fixed" | Cette valeur permet d'indiquer qu'il faut retourner au moins un chiffre. | ||
| "Standard" | Cette valeur permet d'indiquer qu'il faut retourner le séparateur de milliers, au moins un chiffre à la gauche de la décimale et deux chiffres à droite de la décimale. | ||
| "Percent" | Cette valeur permet d'indiquer qu'il faut retourner une valeur de pourcentage, soit un un nombre multiplié par 100 avec un signe de pourcentage (%). Il mettra deux chiffre à la droite de la décimale | ||
| "Scientific" | Cette valeur permet d'indiquer qu'il faut retourner une notation de nombre scientifique. | ||
| ... | ... | ||
| firstdayofweek | Ce paramètre optionnel permet d'indiquer le premier jour de la semaine. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystem | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbSunday | Cette valeur permet d'indiquer qu'il faut utiliser le Dimanche. C'est la valeur par défaut. | |
| 2 | vbMonday | Cette valeur permet d'indiquer qu'il faut utiliser le Lundi. | |
| 3 | vbTuesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mardi. | |
| 4 | vbWednesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mercredi. | |
| 5 | vbThursday | Cette valeur permet d'indiquer qu'il faut utiliser le Jeudi. | |
| 6 | vbFriday | Cette valeur permet d'indiquer qu'il faut utiliser le Vendredi. | |
| 7 | vbSaturday | Cette valeur permet d'indiquer qu'il faut utiliser le Samedi. | |
| firstweekofyear | Ce paramètre optionnel permet d'indiquer le premier jour de l'année. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystem | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbFirstJan1 | Cette valeur permet d'indiquer qu'il faut commencer avec la semaine du premier 1 janvier. C'est la valeur par défaut. | |
| 2 | vbFirstFourDays | Cette valeur permet d'indiquer qu'il faut commencer dans les 4 derniers jours de la semaine de la nouvelle année. | |
| 3 | vbFirstFullWeek | Cette valeur permet d'indiquer qu'il faut commencer dans la premier semaine complète de la nouvelle année. | |
Description
Cette fonction permet de retourner l'expression selon le format spécifié.
Remarques
- La fonction permet de convertir une valeur en une chaîne formatée : La fonction Format transforme une expression numérique, textuelle ou de type Date/Heure en une chaîne de caractères selon un format spécifié. Elle ne modifie jamais la valeur d'origine, mais uniquement sa représentation textuelle. Cette fonction est très utilisée pour améliorer l'affichage des données dans les formulaires, les états et les rapports.
- Elle prend en charge de nombreux formats prédéfinis : Format reconnaît des formats standards tels que "Short Date", "Long Date", "Currency", "Percent", "Scientific" ou encore "General Number". Ces formats permettent de présenter les données de manière uniforme sans avoir à construire manuellement la chaîne de caractères. Ils s'adaptent automatiquement aux paramètres régionaux de Windows.
- Des formats personnalisés peuvent également être utilisés : En plus des formats prédéfinis, Format accepte des modèles personnalisés comme "dd/mm/yyyy", "yyyy-mm-dd", "#,##0.00" ou "000000". Cette possibilité offre un contrôle très précis sur la présentation des données. Elle est particulièrement utile pour produire des rapports ou exporter des informations vers d'autres applications.
- La fonction retourne toujours une chaîne de caractères : Quel que soit le type de la valeur passée en paramètre, le résultat de Format est une chaîne (String). Cela signifie que la valeur obtenue ne doit plus être utilisée directement pour effectuer des calculs numériques ou des comparaisons chronologiques. Si un traitement numérique est nécessaire, il est préférable de conserver la valeur d'origine.
- Le résultat dépend souvent des paramètres régionaux : Les formats prédéfinis tels que "Short Date" ou "Currency" utilisent les paramètres régionaux configurés dans Windows. Ainsi, l'ordre des dates, le séparateur décimal, le séparateur des milliers ou le symbole monétaire peuvent varier d'un ordinateur à l'autre. Cette caractéristique facilite l'internationalisation des applications Access.
- Les paramètres firstdayofweek et firstweekofyear influencent certains formats : Lorsque le format fait intervenir les semaines ou les jours de la semaine, les paramètres optionnels firstdayofweek et firstweekofyear permettent de personnaliser le calcul. Ils déterminent respectivement le premier jour de la semaine et la définition de la première semaine de l'année. Cette fonctionnalité est utile pour les calendriers professionnels et les applications internationales.
- Elle est largement utilisée dans les formulaires et les états : Format permet d'afficher des montants, des dates ou des pourcentages dans une présentation plus conviviale pour l'utilisateur. Par exemple, une date peut être affichée sous la forme "vendredi 26 juin 2026" ou un montant sous la forme "1 250,50 $". Cette capacité améliore considérablement la lisibilité des interfaces.
- Elle est souvent associée à d'autres fonctions de manipulation des dates et des nombres : Format est fréquemment utilisée avec Date, Now, DateAdd, DateDiff, Round, Abs ou encore CStr. Après un calcul, elle permet de présenter le résultat sous une forme adaptée aux besoins de l'utilisateur. Cette combinaison est très courante dans les applications de gestion, les tableaux de bord et les rapports.
- Une utilisation excessive peut compliquer les traitements : Comme Format retourne une chaîne de caractères, il est déconseillé d'utiliser son résultat dans des opérations numériques ou des tris chronologiques. Par exemple, trier des nombres déjà formatés peut produire un ordre alphabétique plutôt qu'un ordre numérique. Il est donc préférable de conserver les valeurs brutes pour les calculs et d'appliquer Format uniquement au moment de l'affichage.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Format est disponible depuis les premières versions de Microsoft Access intégrant VBA et son comportement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant des formats personnalisés ou prédéfinis continueront de fonctionner correctement après une migration vers une version plus récente d'Access.
Exemple
Voici un exemple de comment utiliser la fonction Format avec des nombres dans Microsoft Access :
Format (210.6, "#,##0.00")
Résultat: '210.60'
Format (210.6, "Standard")
Résultat: '210.60'
Format (0.981, "Percent")
Résultat: '98.10%'
Format (1267.5, "Currency")
Résultat: '$1,267.50'
Exemple de code VBA
La fonction Format peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LValue As String
LValue = Format (0.981, "Percent")
Dans cet exemple, la variable appelée LValue contiendrait désormais la valeur de «98,10 %».
Dernière mise à jour : Mardi, le 28 juillet 2015