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)

Str, fonction

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)

Format