Retourne un Variant (String) contenant un expression mis en forme conformément aux instructions contenues dans une expression de format.
|
Avertissement Il existe un problème avec l’utilisation de cette fonction. Le dernier lundi de certaines années civiles peut être retourné en tant que semaine 53 alors qu’il devrait être la semaine 1. Pour plus d’informations et une solution de contournement, consultez Les fonctions Format ou DatePart peuvent retourner un numéro de semaine incorrect pour le dernier lundi de l’année. |
Syntaxe
Format( expression [, format ] [, firstdayofweek ] [, firstweekofyear ] )
La syntaxe de la fonction Format contient les arguments suivants :
|
Argument |
Description |
|
expression |
Obligatoire. Toute expression valide. |
|
format |
Facultatif. Expression de format nommée ou définie par l’utilisateur valide. |
|
premierjoursem |
Facultatif. constante qui spécifie le premier jour de la semaine. |
|
premièresem |
Facultatif. Constante qui spécifie la première semaine de l’année. |
Paramètres
L’argument format peut utiliser divers paramètres, en fonction du type de données de l’argument expression . Pour plus d’informations sur les expressions de format valides, consultez les articles répertoriés dans le tableau suivant.
|
Pour les expressions qui utilisent ce type de données... |
Voir l’article |
|
N’importe quel type |
|
|
Date/heure |
|
|
Numérique |
|
|
Texte et mémo |
|
|
Oui/non |
L’argument firstdayofweek contient les paramètres suivants :
|
Constante |
Valeur |
Description |
|
vbUseSystem |
0 |
Utilisez le paramètre d’API NLS. |
|
VbSunday |
1 |
Dimanche (valeur par défaut) |
|
vbMonday |
2 |
Lundi |
|
vbTuesday |
3 |
Mardi |
|
vbWednesday |
4 |
Mercredi |
|
vbThursday |
5 |
Jeudi |
|
vbFriday |
6 |
Vendredi |
|
vbSaturday |
7 |
Samedi |
L’argument firstweekofyear a les paramètres suivants :
|
Constante |
Valeur |
Description |
|
vbUseSystem |
0 |
Utilisez le paramètre d’API NLS. |
|
vbFirstJan1 |
1 |
Commencez par la semaine au cours de laquelle le 1er janvier se produit (valeur par défaut). |
|
vbFirstFourDays |
2 |
Commencez par la première semaine qui comporte au moins quatre jours dans l’année. |
|
vbFirstFullWeek |
3 |
Commencez par la première semaine complète de l’année. |
Remarques
|
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 des 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 d’heure |
Utilisez des formats de date et d’heure ou des formats numériques. |
|
Cordes |
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, format fournit des fonctionnalités similaires à la fonction Str , bien qu’elle soit internationalement reconnue. Toutefois, les nombres positifs mis en forme sous forme de chaînes à l’aide du format n’incluent pas d’espace de début réservé pour le signe de la valeur ; ceux convertis à l’aide de Str conservent l’espace de début.
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 obtenez l’apparence souhaitée.
Remarque : Si le paramètre de la propriété Calendar est grégorien et que le format spécifie la mise en forme de date, l’expression fournie doit être grégorienne. Si le paramètre 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 reste inchangée. Si le calendrier est Hijri, tous les symboles de format de date (par exemple, dddd, mmmm, aaaa) ont la même signification, mais s’appliquent au calendrier Hijri. Les symboles de format restent en anglais ; les symboles qui entraînent l’affichage du texte (par exemple, AM et PM) affichent la chaîne (anglais 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 les noms de mois complets (les noms de mois Hijri n’ont pas d’abréviations). |
|
a |
1-355 |
|
aaaa |
100-9666 |
Exemples
Utiliser la fonction Format dans une expression Vous pouvez utiliser format partout 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 de contrôle d’une zone de texte sur un formulaire ou un état. Les exemples suivants illustrent une expression que vous pouvez utiliser dans la propriété Filter d’un rapport pour limiter la sortie aux enregistrements de la semaine précédente.
Format([Date],"ww »)=Format(Now(),"ww »)-1
Dans cet exemple, la source d’enregistrement du rapport comporte un champ nommé Date, qui contient la date à laquelle chaque enregistrement particulier a été modifié et qui est utilisé sur le rapport. Lorsque vous exécutez le rapport, ses résultats sont filtrés pour afficher uniquement les enregistrements où la semaine de la valeur dans le champ Date (Format([Date],"ww »)) est égale à la semaine précédente (Format(Maintenant(),"ww »)-1).
Utiliser la fonction Format dans le 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 et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple montre différentes utilisations de la fonction Format pour mettre en forme des valeurs à l’aide de formats nommés et de 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 s’exécute. Lorsque les heures et les 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’ils sont affichés par l’exécution du code, le format d’heure courte et le format de date courte des paramètres régionaux système sont utilisés, ce qui peut différer des paramètres régionaux du code. Pour cet exemple, les paramètres régionaux anglais américains sont supposés.
MyTime et les 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 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".
Utilisation de Format avec des chaînes de longueur nulle
Dans Microsoft Access version 2.0 et versions antérieures, vous pouvez utiliser la fonction Format pour retourner une valeur pour un 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 Microsoft Access versions 97 et ultérieures, vous devez tester séparément le cas Null , puis retourner la valeur appropriée en fonction du résultat. Par exemple, vous pouvez utiliser la fonction IIf dans une expression avec la fonction Format telle que la suivante :
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 Null. Les autres expressions de format utilisées avec la fonction Format continuent de fonctionner comme dans les versions précédentes.
Si vous convertissez une base de données de Microsoft Access 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 Null.
