refcard/java-format.md at main · ctrung/refcard

Affichage : méthode statique `System.out.format()`

var pi = 3.14159265359;
System.out.format("[%f]",pi);       // [3.141593]
System.out.format("[%12.8f]",pi);   // [  3.14159265]
System.out.format("[%012f]",pi);    // [00003.141593]
System.out.format("[%12.2f]",pi);   // [        3.14]
System.out.format("[%-12.2f]",pi);  // [3.14        ]
System.out.format("[%.3f]",pi);     // [3.142]

Dates

// Formatage depuis les objets de l'api date

LocalDate date = LocalDate.of(2022, Month.OCTOBER, 20);
LocalTime time = LocalTime.of(11, 12, 34);
LocalDateTime dt = LocalDateTime.of(date, time);

System.out.println(date.format(DateTimeFormatter.ISO_LOCAL_DATE));
System.out.println(time.format(DateTimeFormatter.ISO_LOCAL_TIME));
System.out.println(dt.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME));

// Personnaliser le format

var f = DateTimeFormatter.ofPattern("MMMM dd, yyyy 'at' hh:mm");
System.out.println(dt.format(f));

// Formater depuis un DateTimeFormatter est équivalent

var dateTime = LocalDateTime.of(2022, Month.OCTOBER, 20, 6, 15, 30);
var formatter = DateTimeFormatter.ofPattern("MM/dd/yyyy hh:mm:ss");

System.out.println(dateTime.format(formatter));   // 20/10/2022 06:15:30
System.out.println(formatter.format(dateTime));   // 20/10/2022 06:15:30

// Insérer du texte entre quote simple (')
// Doubler le quote pour l'échapper    ('') 
var g1 = DateTimeFormatter.ofPattern("MMMM dd', Party''s at' hh:mm");
System.out.println(dt.format(g1)); // October 20, Party's at 06:15

Localisation

D'autres méthodes sont disponibles pour formater en tenant compte de la locale :

pour les dates : DateTimeFormatter.ofLocalizedDate(FormatStyle dateStyle)
pour l'heure : DateTimeFormatter.ofLocalizedTime(FormatStyle timeStyle)
pour les dates heure :
- DateTimeFormatter.ofLocalizedDateTime(FormatStyle dateStyle, FormatStyle timeStyle)
- DateTimeFormatter.ofLocalizedDateTime(FormatStyle dateTimeStyle)
pour changer la locale : withLocale(Locale locale)

Exemples :

var italy = new Locale("it", "IT");
var dt = LocalDateTime.of(2022, Month.OCTOBER, 20, 15, 12, 34);

var dtf = DateTimeFormatter.ofLocalizedDate(SHORT);
System.out.println(dtf.withLocale(locale).format(dt));      // 20/10/22

dtf = DateTimeFormatter.ofLocalizedTime(SHORT);
System.out.println(dtf.withLocale(locale).format(dt));      // 15:12

dtf = DateTimeFormatter.ofLocalizedDateTime(SHORT, SHORT);
System.out.println(dtf.withLocale(locale).format(dt));      // 20/10/22, 15:12

Localisation

Pour les dates, voir le paragraphe Date > Localisation sur cette page.

Pour les nombres, voir le paragraphe Nombres : classe NumberFormat > Localisation sur cette page.

`Category`

Par ailleurs la classe java.util.Locale est composée d'options réparties dans des java.util.Locale.Category. Les deux Category existantes sont DISPLAY et FORMAT. Java supporte la configuration des catégories par une Locale distincte.

Exemple :

public static void main(String[] args) {

    var spain = new Locale("es", "ES");
    var money = 1.23;

    // Tout en en_US
    Locale.setDefault(new Locale("en", "US"));
    printCurrency(spain, money); // $1.23, Spanish

    // Display en es_ES, format en en_US
    Locale.setDefault(Category.DISPLAY, spain);
    printCurrency(spain, money); // $1.23, español

    // Tout en es_ES
    Locale.setDefault(Category.FORMAT, spain);
    printCurrency(spain, money); // 1,23 €, español
}

public static void printCurrency(Locale locale, double money) {
    System.out.println(
            NumberFormat.getCurrencyInstance().format(money)
                    + ", " + locale.getDisplayLanguage());
}

`ResourceBundle`

Fichier properties de la forme <nom>_<locale>.properties contenant des clés-valeurs
Dans le code, appel de ResourceBundle.getBundle(String nom) ou ResourceBundle.getBundle(String nom, Locale locale) pour obtenir une instance de ResourceBundle
Appel de resourceBundle.getString(String key) pour obtenir la valeur
Une hiérarchie de resource bundles est constituée pour réutiliser une clé-valeur existante. Le resource bundle parent est déduit du nom en enlevant progressivement un bout (d'abord le pays, puis la langue)

Exemple

Zoo.properties

name=Vancouver Zoo

Zoo_en.properties

hello=Hello
open=is open

Zoo_en_US.properties

name=The Zoo

Zoo_en_CA.properties

visitors=Canada visitors

Locale.setDefault(new Locale("en", "US"));
Locale locale = new Locale("en", "CA");
ResourceBundle rb = ResourceBundle.getBundle("Zoo", locale);
System.out.print(rb.getString("hello"));      // [Hello] provenant de Zoo_en.properties
System.out.print(". ");
System.out.print(rb.getString("name"));       // [Vancouver Zoo] provenant de Zoo.properties
System.out.print(" ");
System.out.print(rb.getString("open"));       // [is open] provenant de Zoo_en.properties
System.out.print(" ");
System.out.print(rb.getString("visitors"));   // [Canada visitors] provenant de Zoo_en_CA.properties

Dans l'exemple, la hiérarchie constituée et l'ordre de priorité est :

Zoo_en_CA.properties
Zoo_en.properties
Zoo.properties A aucun moment, Zoo_en_US.properties n'est consulté. Attention, si une clé-valeur est absente, MissingResourceException est jetée.

Formatter les messages d'un resource bundle

Utilisation d'emplacement réservé, exemple : helloByName=Hello, {0} and {1}.

String format = rb.getString("helloByName");
System.out.print(MessageFormat.format(format, "Tammy", "Henry"));

`ResourceBundle` vs `Properties`

https://stackoverflow.com/questions/14883000/why-not-use-resourcebundle-instead-of-properties

Les deux classes ont des objectifs suffisamment distincts pour différencier leurs usages.

ResourceBundle sert principalement pour l'internalisation (i18n) et la localisation (i10n). Une hierarchie de fichiers est constituée pour trouver la valeur et en cas d'absence une MissingResourceException est jetée.

Properties a un usage plus générique (liste de clé-valeur) et ne gère pas l'internationalisation. La classe ressemble plus à une Map<String, String> chargeable à partir d'un fichier. De plus, il est possible de définir une valeur par défaut en l'absence d'une clé avec la méthode getProperty(String key, String defaultValue)

Nombres : classe `NumberFormat`

interface NumberFormat
class DecimalFormat implements NumberFormat

// locale fr, FR

double d = 1234.567;
NumberFormat f1 = new DecimalFormat("###,###,###.0");
System.out.println(f1.format(d)); // 1 234.6

NumberFormat f2 = new DecimalFormat("000,000,000.00000");
System.out.println(f2.format(d)); // 000 001 234.56700

NumberFormat f3 = new DecimalFormat("Votre solde €#,###,###.##");
System.out.println(f3.format(d)); // Votre solde €1 234.57

Caractères spéciaux de formatage :

# : pas d'affichage si pas de chiffre à cette position
0 : afiichage d'un zéro si pas de chiffre à cette position

localisation

NB : getInstance() retourne une instance avec la Locale du système par défaut.

Générique :
- NumberFormat.getInstance()
- NumberFormat.getInstance(Locale locale)
Identique à getInstance
- NumberFormat.getNumberInstance()
- NumberFormat.getNumberInstance(Locale locale)
Formater les montants :
- NumberFormat.getCurrencyInstance()
- NumberFormat.getCurrencyInstance(Locale locale)
Formater les pourcentages :
- NumberFormat.getPercentInstance()
- NumberFormat.getPercentInstance(Locale locale)
Formater les nombres décimaux :
- NumberFormat.getIntegerInstance()
- NumberFormat.getIntegerInstance(Locale locale)
Formater les nombres de manière compact :
- NumberFormat.getCompactNumberInstance()
- NumberFormat.getCompactNumberInstance(Locale locale, NumberFormat.Style formatStyle)

Exemples :

var ca = NumberFormat.getInstance(Locale.CANADA_FRENCH);
System.out.println(ca.format(attendeesPerMonth)); // 266 666

double price = 48;
var myLocale = NumberFormat.getCurrencyInstance();
System.out.println(myLocale.format(price));       // 48,00 $ CA

int nb = 7_123_456;
System.out.println(NumberFormat.getCompactNumberInstance().format(nb));                                  // 7M
System.out.println(NumberFormat.getCompactNumberInstance(Locale.getDefault(), Style.SHORT).format(nb));  // 7M
System.out.println(NumberFormat.getCompactNumberInstance(Locale.getDefault(), Style.LONG).format(nb));   // 7 million

String : méthode d'instance `string.formatted()`

String mesg = "Hello %s, order %d is ready".formatted(name, orderId);

String : méthode statique `String.format()`

String mesg = String.format("Hello %s, order %d is ready", name, orderId);

Symboles :

%s : tout type, principalement valeurs de type String
%d : valeurs entières comme int ou long
%f : valeurs flottantes comme float ou double
%n : insère un saut de ligne

Caractères spéciaux de formatage :

%x : longueur totale + padding gauche avec des espaces
%-x : longueur totale + padding droit avec des espaces
%0x : longueur totale + padding avec des zéros
.xf : nombre de chiffre après la virgule

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Affichage : méthode statique `System.out.format()`

Dates

Localisation

Localisation

`Category`

`ResourceBundle`

Formatter les messages d'un resource bundle

`ResourceBundle` vs `Properties`

Nombres : classe `NumberFormat`

localisation

String : méthode d'instance `string.formatted()`

String : méthode statique `String.format()`

FilesExpand file tree

java-format.md

Latest commit

History

java-format.md

File metadata and controls

Affichage : méthode statique System.out.format()

Dates

Localisation

Localisation

Category

ResourceBundle

Formatter les messages d'un resource bundle

ResourceBundle vs Properties

Nombres : classe NumberFormat

localisation

String : méthode d'instance string.formatted()

String : méthode statique String.format()

Affichage : méthode statique `System.out.format()`

`Category`

`ResourceBundle`

`ResourceBundle` vs `Properties`

Nombres : classe `NumberFormat`

String : méthode d'instance `string.formatted()`

String : méthode statique `String.format()`