Section courante

A propos

Section administrative du site

Format

Format
  String
C# (C Sharp) System

Syntaxe

public static string Format(string format,Object arg0);
public static string Format(string format,params Object[] args);
public static string Format(IFormatProvider provider,string format,params Object[] args);
public static string Format(string format,Object arg0,Object arg1);
public static string Format(string format,Object arg0,Object arg1,Object arg2);

Paramètres

Nom Description
format Ce paramètre permet d'indiquer le format du formatage devant être effectué sur l'objet. Voici la plupart des formats supportés avec les spécificateurs pour les nombres :
Spécificateur Valeur Description
c "{0:c}" Ce spécificateur permet d'indiquer une valeur monétaire (exemple : 5,43$)
d "{0:d}" Ce spécificateur permet d'indiquer une valeur décimal
e "{0:e}" Ce spécificateur permet d'indiquer une valeur exponentiel de style scientifique (exemple : 5.432100e+000)
f "{0:f}" Ce spécificateur permet d'indiquer une valeur avec un nombre de décimal fixe après la virgule (ou le point)
g "{0:g}" Ce spécificateur permet d'indiquer une valeur avec une présentation générale.
n "{0:n}" Ce spécificateur permet d'indiquer une valeur avec une présentation de nombre.
r "{0:r}" Ce spécificateur permet d'indiquer une valeur arrondie.
x "{0:x4}" Ce spécificateur permet d'indiquer une valeur avec une base numérique hexadécimal.
Voici la plupart des formats utilisateurs supportés avec les spécificateurs pour les nombres :
Spécificateur Valeur Description
0 "{0:00.000}" Ce spécificateur permet d'indiquer une valeur avec 3 chiffres après la virgule et complète avec des zéros si nécessaire.
# "{0:#.###}" Ce spécificateur permet d'indiquer une valeur avec 3 décimales après la virgule.
. "{0:0.0}" Ce spécificateur permet d'indiquer l'emplacement où séparer les décimal d'un nombre réel.
, "{0:0,0}" Ce spécificateur permet d'indiquer le sépérateur de millier.
% "{0:0%}" Ce spécificateur permet d'indiquer une annotation de pourcentage.
Voici la plupart des formats supportés avec les spécificateurs pour les dates :
Spécificateur Valeur Description
d "d" Ce spécificateur permet d'indiquer une date de format court (exemple : 2010-01-31).
D "D" Ce spécificateur permet d'indiquer une date de format long (exemple : 31 June 2010).
f "f" Ce spécificateur permet d'indiquer la date de format long et l'heure de format court.
F "F" Ce spécificateur permet d'indiquer la date de format long et l'heure de format long.
g "g" Ce spécificateur permet d'indiquer la date de format court et l'heure de format court.
G "G" Ce spécificateur permet d'indiquer la date de format court et l'heure de format long.
M "M" Ce spécificateur permet d'indiquer le jour et le mois.
r "r" Ce spécificateur permet d'indiquer la date et l'heure selon la norme du RFC1123.
s "s" Ce spécificateur permet d'indiquer la date et l'heure triable.
t "t" Ce spécificateur permet d'indiquer l'heure de format court (exemple : 11:00).
T "T" Ce spécificateur permet d'indiquer l'heure de format long (exemple : 11:00).
u "u" Ce spécificateur permet d'indiquer la date et l'heure universel.
Y "Y" Ce spécificateur permet d'indiquer le mois et l'année.
Voici la plupart des formats utilisateurs supportés avec les spécificateurs pour les dates (ceux-ci peuvent être combiné dans une chaine de caractères, exemple : {HH:mm:ss}) :
Spécificateur Valeur Description
dd "{...dd...}" Ce spécificateur permet d'indiquer le nombre du jour sur deux chiffres (avec un zéro avant si inférieur à 9).
ddd "{...ddd...}" Ce spécificateur permet d'indiquer le nom du jour court.
dddd "{...dddd...}" Ce spécificateur permet d'indiquer le nom du jour long.
hh "{...hh...}" Ce spécificateur permet d'indiquer le nombre d'heure sur 12 heures avec deux chiffres (avec un zéro avant si inférieur à 9).
HH "{...HH...}" Ce spécificateur permet d'indiquer le nombre d'heure sur 24 heures avec deux chiffres (avec un zéro avant si inférieur à 9).
mm "{...mm...}" Ce spécificateur permet d'indiquer le nombre de minute avec deux chiffres (avec un zéro avant si inférieur à 9).
MM "{...MM...}" Ce spécificateur permet d'indiquer le numéro du mois avec deux chiffres (avec un zéro avant si inférieur à 9).
MMM "{...MMM...}" Ce spécificateur permet d'indiquer le nom du mois court.
MMMM "{...MMMM...}" Ce spécificateur permet d'indiquer le nom du mois long.
ss "{...ss...}" Ce spécificateur permet d'indiquer le nombre de secondes avec deux chiffres (avec un zéro avant si inférieur à 9).
tt "{...tt...}" Ce spécificateur permet d'indiquer AM (avant-midi) ou PM (après-midi).
yy "{...yy...}" Ce spécificateur permet d'indiquer l'année avec deux chiffres (avec un zéro avant si inférieur à 9).
yyyy "{...yyyy...}" Ce spécificateur permet d'indiquer l'année avec deux chiffres (avec un zéro avant si inférieur à 9).
: "{...:...}" Ce spécificateur permet d'indiquer le séparateur des heures.
: "{.../...}" Ce spécificateur permet d'indiquer le séparateur de date.
provider Ce paramètre permet d'indiquer les informations culturel pour le formatage des informations.
arg0 Ce paramètre permet d'indiquer l'objet devant être formater.
arg1 Ce paramètre permet d'indiquer le deuxième objet devant être formater.
arg2 Ce paramètre permet d'indiquer le troisième objet devant être formater.
args Ce paramètre permet d'indiquer un tableau d'objet pouvant contenir zéro ou plusieurs objets à formater.

Retour

Valeur Description
chaine de caractères Ces valeurs correspondent à la valeur de formatage demandé.

Description

Cette méthode permet d'effectuer le formatage de valeurs (généralement numérique) pour des nombres de valeurs monétaire, régional, date, scientifique et autres par exemple.

Exemple

Voici divers exemple d'affichages de format :

Essayer maintenant !
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Text;
  4.  
  5. namespace SystemStringFormatSamples
  6. {
  7.     class Program
  8.     {
  9.  
  10.         static void Main(string[] args)
  11.         {
  12.             Console.WriteLine(String.Format("Entier {{0:d}} = {0:d}", 15));
  13.             Console.WriteLine(String.Format("Hexadecimal {{0:x}} = {0:x}", 16));
  14.             Console.WriteLine(String.Format("Octal = {0:c}", Convert.ToString(16, 8)));
  15.             Console.WriteLine(String.Format("Chaine de caracteres {{0:c}} = {0:c}", "message"));
  16.             Console.WriteLine(String.Format("Reel {{0:e}} = {0:e}", 123.45));
  17.             Console.WriteLine(String.Format("Reel {{0:f}} = {0:f}", 123.45));  
  18.             Console.WriteLine("Heure courante :" + String.Format("{0:0000}-{1:00}-{2:00} {3:00}:{4:00}:{5:00}",
  19.                 System.DateTime.Now.Year, System.DateTime.Now.Month, System.DateTime.Now.Day,
  20.                 System.DateTime.Now.Hour, System.DateTime.Now.Minute, System.DateTime.Now.Second));
  21.         } 
  22.  
  23.     }
  24. }

on obtiendra le résultat suivant si l'heure courante est 8:24 du matin le 27 janvier 2009 :

Boujour!
Entier {0:d} = 15
Hexadecimal {0:x} = 10
Octal = 20
Chaine de caracteres {0:c} = message
Reel {0:e} = 1,234500e+002
Reel {0:f} = 123,45
Heure courante :2009-01-27 08:24:00

Voir également

Langage de programmation - C# (C Sharp) - Type de données élémentaire - Les chaines de caractères

Dernière mise à jour : Dimanche, le 14 juin 2015