Format, fonction
Mise à jour : novembre 2007
Retourne une chaîne mise en forme conformément aux instructions contenues dans une expression String de format.
Public Shared Function Format( _
ByVal Expression As Object, _
Optional ByVal Style As String = "" _
) As String
Paramètres
Expression
Requis. Toute expression valide.Style
Facultatif. Expression String de format nommée valide ou définie par l'utilisateur.
Paramètres
Pour obtenir des informations sur la création de l'argument Style, consultez la rubrique appropriée répertoriée ci-dessous :
Pour mettre en forme |
Procédez comme suit |
---|---|
Nombres |
Utilisez des formats numériques prédéfinis ou créez des formats numériques définis par l'utilisateur. |
Dates et heures |
Utilisez des formats de date/heure 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. |
Si vous essayez de mettre en forme un nombre sans spécifier Style, la fonction Format fournit une fonctionnalité similaire à la fonction Str, bien qu'elle respecte les conventions internationales. Toutefois, les nombres positifs mis en forme en tant que chaînes à l'aide de la fonction Format ne contiennent pas d'espace à gauche réservé au signe de la valeur, contrairement à ceux convertis à l'aide de la fonction Str.
Notes
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 afin d'obtenir l'aspect voulu.
La méthode String.Format fournit également une fonctionnalité similaire.
Exemple
L'exemple suivant illustre différentes utilisations de la fonction Format pour mettre en forme des valeurs utilisant à la fois les formats String et les formats définis par l'utilisateur. Pour le séparateur de date (/), le séparateur d'heure (:) et les indicateurs AM/PM (t et tt), le résultat réel mis en forme affiché par votre système dépend des paramètres régionaux utilisés par le code. Lorsque les heures et les dates sont affichées dans l'environnement de développement, les formats d'heure abrégée et de date courte des paramètres régionaux de code sont utilisés.
Remarque : |
---|
Pour paramètres régionaux configurés avec une horloge au format 24 heures, les indicateurs AM/PM (t et tt) n'affichent rien. |
Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")
' Returns the value of TestDateTime in user-defined date/time formats.
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)
' User-defined numeric formats.
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")
Configuration requise
Espace de noms :Microsoft.VisualBasic
**Module :**Strings
**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Voir aussi
Référence
Liste des manipulations de chaînes
Formats différents pour valeurs numériques différentes (fonction Format)
Formats de date/heure prédéfinis (fonction Format)
Formats numériques prédéfinis (fonction Format)
Fonctions de conversion de types de données
Formats de date/heure définis par l'utilisateur (fonction Format)
Formats numériques définis par l'utilisateur (fonction Format)