Partager via

Strings.Format, méthode

  • Article

Retourne une chaîne mise en forme conformément aux instructions contenues dans une expression String de format.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Format ( _
    Expression As Object, _
    <OptionalAttribute> Optional Style As String = "" _
) As String
'Utilisation
Dim Expression As Object
Dim Style As String
Dim returnValue As String

returnValue = Strings.Format(Expression, Style)

public static string Format (
    Object Expression,
    [OptionalAttribute] string Style
)

public:
static String^ Format (
    Object^ Expression, 
    [OptionalAttribute] String^ Style
)

public static String Format (
    Object Expression, 
    /** @attribute OptionalAttribute() */ String Style
)

public static function Format (
    Expression : Object, 
    Style : String
) : String

Paramètres

  • Expression
    Obligatoire. Toute expression valide.
  • Style
    Facultatif. Expression String de format nommée ou définie par l'utilisateur valide.

Valeur de retour

Retourne une chaîne mise en forme conformément aux instructions contenues dans une expression String de format.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Format, fonction.

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 System.String.Format fournit également une fonctionnalité similaire.

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/d'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 aux nombres positifs convertis à l'aide de la fonction Str.

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.

Notes

Pour les 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%")

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
Format

Autres ressources

Format, fonction
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)