Zum Inhalt springen

Lokalisierung

1.234,50 € in Deutschland, $1,234.50 in den USA, CHF 1’234.50 in der Schweiz – dieselbe Zahl, drei Schreibweisen. Dazu Datumsangaben, Wochentage, die Sortierung von Umlauten und natürlich die Texte selbst. Ein Programm an all das anzupassen, heißt Lokalisierung.

  • mit Locale eine Sprache und ein Land angeben
  • Zahlen, Beträge und Prozente mit NumberFormat passend formatieren und lesen
  • Datumsangaben mit DateTimeFormatter in einer Sprache ausgeben
  • Texte mit einem Collator richtig sortieren
  • Texte in .properties-Dateien auslagern und mit ResourceBundle laden

Demo-Code: 30-lokalisierung

⤓ demo-lokalisierung.zip herunterladen

Der fertige Stand aus der Vorführung – zum Nachlesen, Ausprobieren und Weiterbauen.

Entpacke die ZIP-Datei nach C:\dev\intellij. In IntelliJ: File → Open… → den Ordner 30-lokalisierung wählen → OK → Trust Project. IntelliJ erkennt die pom.xml und lädt die Bibliotheken selbst herunter – das dauert beim ersten Mal einen Moment.

Enthält: pom.xml, Zahlen.java, Datum.java, Sortieren.java, Uebersetzt.java, texte.properties, texte_en.properties

Ein Locale beschreibt, für wen formatiert wird: eine Sprache und meist ein Land. Geschrieben wird es wie de_DE – Deutsch in Deutschland – oder de_CH – Deutsch in der Schweiz.

so bekommt man es Beispiel
Konstanten Locale.GERMANY, Locale.US, Locale.FRANCE, nur Sprache: Locale.GERMAN, Locale.ENGLISH
aus Sprache und Land Locale.of("de", "CH")
aus einem Sprach-Tag Locale.forLanguageTag("de-CH") – praktisch für Programmargumente
die Einstellung des Rechners Locale.getDefault() – unter Windows aus den Regionseinstellungen

Schon seit Woche 1 ist ein Locale im Spiel, ohne dass wir es gesehen haben: printf schreibt 3,14 mit Komma, weil Locale.getDefault() auf den Schulungsrechnern de_DE ist.

Zahlen.java
package de.drv.sprachen;
import java.text.NumberFormat;
import java.text.ParseException;
import java.util.Locale;
/** Dieselbe Zahl in vier Ländern. */
public class Zahlen {
public static void main(String[] args) throws ParseException {
System.out.println("Standard dieses Rechners: " + Locale.getDefault());
double betrag = 1234.5;
Locale[] laender = {Locale.GERMANY, Locale.of("de", "CH"), Locale.US, Locale.FRANCE};
for (Locale land : laender) {
NumberFormat zahl = NumberFormat.getNumberInstance(land);
NumberFormat geld = NumberFormat.getCurrencyInstance(land);
NumberFormat prozent = NumberFormat.getPercentInstance(land);
System.out.printf("%-6s %-10s %-14s %s%n", land, zahl.format(betrag), geld.format(betrag), prozent.format(0.19));
}
// Und zurück: ein Text, wie ihn Menschen in Deutschland tippen
Number gelesen = NumberFormat.getNumberInstance(Locale.GERMANY).parse("1.234,56");
System.out.println("gelesen: " + gelesen.doubleValue());
}
}
Terminal-Fenster
Standard dieses Rechners: de_DE
de_DE 1.234,5 1.234,50 € 19 %
de_CH 1’234.5 CHF 1’234.50 19%
en_US 1,234.5 $1,234.50 19%
fr_FR 1 234,5 1 234,50 € 19 %
gelesen: 1234.56
  • NumberFormat.getNumberInstance(land) schreibt eine Zahl mit den Trennzeichen des Landes. getCurrencyInstance setzt die Währung dazu – und rundet auf zwei Nachkommastellen. getPercentInstance macht aus 0.19 ein 19 %.
  • parse geht den umgekehrten Weg: aus dem Text 1.234,56 die Zahl 1234.56. Das kann Double.parseDouble nicht – es kennt nur den Punkt.
  • Die Regeln – Tausenderpunkt, Apostroph, Leerzeichen, Währung vor oder hinter der Zahl – stecken im JDK. Niemand muss sie selbst kennen.
Datum.java
package de.drv.sprachen;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.Locale;
/** Dasselbe Datum in drei Sprachen. */
public class Datum {
public static void main(String[] args) {
LocalDate tag = LocalDate.of(2026, 10, 23);
for (Locale sprache : new Locale[] {Locale.GERMANY, Locale.US, Locale.FRANCE}) {
String kurz = tag.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM).withLocale(sprache));
String lang = tag.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL).withLocale(sprache));
System.out.printf("%-6s %-14s %s%n", sprache, kurz, lang);
}
// Eigenes Muster – die Namen von Tag und Monat kommen aus der Sprache
DateTimeFormatter muster = DateTimeFormatter.ofPattern("EEEE, d. MMMM yyyy", Locale.GERMAN);
System.out.println(tag.format(muster));
}
}
Terminal-Fenster
de_DE 23.10.2026 Freitag, 23. Oktober 2026
en_US Oct 23, 2026 Friday, October 23, 2026
fr_FR 23 oct. 2026 vendredi 23 octobre 2026
Freitag, 23. Oktober 2026
  • DateTimeFormatter.ofLocalizedDate(stil) kennt vier Stile: SHORT, MEDIUM, LONG und FULL. Mit withLocale wählt man die Sprache. Auch die Reihenfolge – Tag vor Monat oder Monat vor Tag – kommt aus dem Land.
  • Bei einem eigenen Muster wie "EEEE, d. MMMM yyyy" liefert die Sprache die Namen: EEEE ist der Wochentag, MMMM der Monat. Ohne Angabe nimmt ofPattern das Locale des Rechners.
Sortieren.java
package de.drv.sprachen;
import java.text.Collator;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
/** Alphabetisch ist nicht gleich alphabetisch. */
public class Sortieren {
public static void main(String[] args) {
List<String> namen = new ArrayList<>(List.of("Zander", "Öztürk", "Ober", "ärger", "Abel", "über", "Ulm", "Arnold"));
namen.sort(null); // natürliche Ordnung von String: nach dem Zeichencode
System.out.println("String: " + namen);
// Ein Collator sortiert nach den Regeln einer Sprache – er ist ein Comparator
namen.sort(Collator.getInstance(Locale.GERMAN));
System.out.println("Collator: " + namen);
}
}
Terminal-Fenster
String: [Abel, Arnold, Ober, Ulm, Zander, Öztürk, ärger, über]
Collator: [Abel, ärger, Arnold, Ober, Öztürk, über, Ulm, Zander]

Die natürliche Ordnung von String vergleicht Zeichencodes: Erst kommen alle Großbuchstaben, dann alle Kleinbuchstaben, dann die Umlaute. Für ein Telefonbuch ist das unbrauchbar. Ein Collator sortiert nach den Regeln einer Sprache: ä neben a, ö neben o, Groß- und Kleinschreibung erst in zweiter Linie.

Ein Collator ist ein Comparator – deshalb passt er direkt in sort. Das ist die Antwort auf die offene Frage aus dem Collection-Kapitel, warum „über“ hinter „zur“ landet.

Texte, die ein Benutzer sieht, gehören nicht in den Quelltext, sondern in .properties-Dateien – eine pro Sprache. In einem Maven-Projekt liegen sie unter src\main\resources:

texte.properties
# Deutsch – die Grundfassung
begruessung=Hallo {0}!
stand=Am {0} hast du {1} Kapitel bearbeitet.
abschied=Bis morgen!
texte_en.properties
# English
begruessung=Hello {0}!
stand=On {0} you worked through {1} chapters.
abschied=See you tomorrow!
  • Jede Zeile ist Schlüssel = Text. Zeilen mit # sind Kommentare.
  • Der Dateiname bestimmt die Sprache: texte.properties ist die Grundfassung, texte_en.properties die englische. Für das Schweizerdeutsch käme texte_de_CH.properties dazu.
  • {0}, {1} sind Platzhalter. Ihre Reihenfolge darf sich je Sprache unterscheiden – im Englischen steht das Datum an anderer Stelle im Satz.
  • Seit Java 9 werden .properties-Dateien als UTF-8 gelesen – Umlaute dürfen direkt drinstehen.
Uebersetzt.java
package de.drv.sprachen;
import java.text.MessageFormat;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.Locale;
import java.util.ResourceBundle;
/** Texte aus .properties-Dateien – je nach Sprache eine andere Datei. */
public class Uebersetzt {
public static void main(String[] args) {
LocalDate tag = LocalDate.of(2026, 10, 23);
for (Locale sprache : new Locale[] {Locale.GERMAN, Locale.ENGLISH}) {
ResourceBundle texte = ResourceBundle.getBundle("texte", sprache);
String datum = tag.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.LONG).withLocale(sprache));
System.out.println(MessageFormat.format(texte.getString("begruessung"), "Anna"));
System.out.println(MessageFormat.format(texte.getString("stand"), datum, 12));
System.out.println(texte.getString("abschied"));
System.out.println();
}
}
}
Terminal-Fenster
Hallo Anna!
Am 23. Oktober 2026 hast du 12 Kapitel bearbeitet.
Bis morgen!
Hello Anna!
On October 23, 2026 you worked through 12 chapters.
See you tomorrow!
  • ResourceBundle.getBundle("texte", sprache) sucht die passende Datei – texte_en.properties für Englisch – und fällt auf die Grundfassung zurück, wenn es keine gibt.
  • getString(schluessel) liefert einen Text. Ein unbekannter Schlüssel führt zu einer MissingResourceException.
  • MessageFormat.format(text, werte …) setzt die Werte in die Platzhalter ein.

Maven kopiert alles aus src\main\resources beim Übersetzen nach target\classes – dorthin, wo auch die .class-Dateien liegen. Deshalb findet getBundle die Dateien auf dem Classpath, ohne Pfadangabe.

Arbeite im Demo-Projekt 30-lokalisierung.

  1. Beträge und Datum: Ein Programm Kassenbon bekommt ein Sprach-Tag als Argument – etwa de-DE, de-CH oder en-US – und gibt einen Bon für drei Artikel aus: Kaffee 3,20, Croissant 2,45, Orangensaft 3,90. Jeder Preis und die Summe erscheinen in der Währung des Landes, das Datum des Bons in der Sprache des Landes.

  2. Texte aus einer Datei: Die festen Texte des Bons – Überschrift, Artikelanzahl, „Summe“ und ein Dank – kommen aus bon.properties und bon_en.properties.

    Terminal-Fenster
    Receipt of October 23, 2026
    Kaffee $3.20
    Croissant $2.45
    Orangensaft $3.90
    3 items
    Total $9.55
    Thank you for shopping with us!

    Was passiert mit fr-FR, für das es keine Texte gibt?

  3. Wochentage: Gib eine Tabelle der Wochentage in Deutsch, Englisch und Französisch aus – jeweils lang und kurz. Tipp: DayOfWeek.values() liefert alle sieben Tage, und jeder kennt getDisplayName(TextStyle.FULL, sprache).

  4. Für Schnelle: In einer Teilnehmerliste stehen Namen mehrfach – mal groß, mal klein, mal mit und mal ohne Akzent: Müller, MÜLLER, Muller, Zoë, Zoe … Finde heraus, wie viele verschiedene Namen es gibt. Tipp: Ein Collator hat eine Stärke (setStrength), und ein TreeSet nimmt einen Comparator im Konstruktor.

Lösung
bon.properties
titel=Kassenbon vom {0}
anzahl={0} Artikel
summe=Summe
dank=Vielen Dank für Ihren Einkauf!
  • Locale.forLanguageTag(args[0]) macht aus de-CH ein Locale – genau das Format, das man auf der Kommandozeile tippt.
  • Eine LinkedHashMap behält die Reihenfolge der Artikel.
  • Mit fr-FR gibt es keine französischen Texte. getBundle versucht dann zuerst die Sprache des Rechners und danach die Grundfassung – hier ist beides Deutsch. Das Datum dagegen kommt aus dem JDK und ist trotzdem französisch: Kassenbon vom 23 octobre 2026. Für eine echte Anwendung fehlt also eine Datei bon_fr.properties.
Kassenbon.java
package de.drv.sprachen;
import java.text.MessageFormat;
import java.text.NumberFormat;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.LinkedHashMap;
import java.util.Locale;
import java.util.Map;
import java.util.ResourceBundle;
/** Stufen 1 und 2: ein Kassenbon – Beträge, Datum und Texte passend zur Sprache und zum Land. */
public class Kassenbon {
public static void main(String[] args) {
Locale land = args.length > 0 ? Locale.forLanguageTag(args[0]) : Locale.getDefault();
Map<String, Double> artikel = new LinkedHashMap<>();
artikel.put("Kaffee", 3.20);
artikel.put("Croissant", 2.45);
artikel.put("Orangensaft", 3.90);
NumberFormat geld = NumberFormat.getCurrencyInstance(land);
ResourceBundle texte = ResourceBundle.getBundle("bon", land);
String datum = LocalDate.of(2026, 10, 23)
.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.LONG).withLocale(land));
System.out.println(MessageFormat.format(texte.getString("titel"), datum));
double summe = 0;
for (Map.Entry<String, Double> posten : artikel.entrySet()) {
System.out.printf("%-14s %12s%n", posten.getKey(), geld.format(posten.getValue()));
summe += posten.getValue();
}
System.out.println(MessageFormat.format(texte.getString("anzahl"), artikel.size()));
System.out.printf("%-14s %12s%n", texte.getString("summe"), geld.format(summe));
System.out.println(texte.getString("dank"));
}
}
Lösung
Terminal-Fenster
Montag Mo. Monday Mon lundi lun.
Dienstag Di. Tuesday Tue mardi mar.
Mittwoch Mi. Wednesday Wed mercredi mer.
Donnerstag Do. Thursday Thu jeudi jeu.
Freitag Fr. Friday Fri vendredi ven.
Samstag Sa. Saturday Sat samedi sam.
Sonntag So. Sunday Sun dimanche dim.
Wochentage.java
package de.drv.sprachen;
import java.time.DayOfWeek;
import java.time.format.TextStyle;
import java.util.Locale;
/** Stufe 3: die Wochentage in drei Sprachen – lang und kurz. */
public class Wochentage {
public static void main(String[] args) {
Locale[] sprachen = {Locale.GERMAN, Locale.ENGLISH, Locale.FRENCH};
for (DayOfWeek tag : DayOfWeek.values()) {
for (Locale sprache : sprachen) {
System.out.printf("%-12s %-5s", tag.getDisplayName(TextStyle.FULL, sprache),
tag.getDisplayName(TextStyle.SHORT, sprache));
}
System.out.println();
}
}
}
Lösung
Terminal-Fenster
8 Einträge, 4 verschiedene: [Müller, Schmidt, Weiß, Zoë]
Müller = muller? true

Mit der Stärke PRIMARY vergleicht der Collator nur die Grundbuchstaben: ü und u, ë und e, groß und klein gelten als gleich. Das TreeSet benutzt den Collator statt equals – was er für gleich hält, kommt nur einmal hinein. Behalten wird jeweils der erste Eintrag.

Dubletten.java
package de.drv.sprachen;
import java.text.Collator;
import java.util.List;
import java.util.Locale;
import java.util.Set;
import java.util.TreeSet;
/** Stufe 4: Namen, die sich nur in Großschreibung oder Akzenten unterscheiden, als gleich behandeln. */
public class Dubletten {
public static void main(String[] args) {
List<String> namen = List.of("Müller", "Schmidt", "MÜLLER", "Muller", "Weiß", "schmidt", "Zoë", "Zoe");
Collator vergleich = Collator.getInstance(Locale.GERMAN);
vergleich.setStrength(Collator.PRIMARY); // nur die Grundbuchstaben zählen
// Ein TreeSet mit Collator: Was der Collator für gleich hält, kommt nur einmal hinein
Set<String> verschieden = new TreeSet<>(vergleich);
verschieden.addAll(namen);
System.out.println(namen.size() + " Einträge, " + verschieden.size() + " verschiedene: " + verschieden);
System.out.println("Müller = muller? " + (vergleich.compare("Müller", "muller") == 0));
}
}