Pluralformen, Datumsangaben und Zahlen richtig handhaben

Lass die Sprache Grammatik und Formatierung bestimmen. Die Anwendung behält dabei die Kontrolle über Werte, Einheiten und Zeitzonen.

Bei einer Anzahl sind zwei Entscheidungen zu treffen: welche Zahl die Anwendung meint und wie die Sprache der Lesenden diese Menge ausdrückt. Für Datumsangaben und Geldbeträge gilt dieselbe Trennung. Halte Werte bis zur Ausgabe in strukturierter Form, damit sich Grammatik, Trennzeichen, Währung und Zeitzone gezielt wählen lassen.

Diese Beispiele verwenden @lingo.dev/react. Native Ressourcensysteme nutzen jeweils ihre eigene Nachrichtensyntax und eigene Generatoren. Eine ICU-ähnliche Notation macht die Laufzeitumgebungen nicht beliebig austauschbar.

Übergib dem Formatierer eine vollständige Nachricht #

Verwende in einer Komponente unter LingoProvider die numerische Anzahl zusammen mit einer Pluralnachricht:

tsx
const l = useLingo();

const label = l.plural(
  count,
  { one: "# item", other: "# items" },
  { context: "Number of items in the shopping cart" },
);

Importiere useLingo aus @lingo.dev/react; count ist der numerische Wert der Anwendung. Die Laufzeitumgebung erstellt eine ICU-Nachricht und formatiert die Übersetzung aus dem Katalog anhand der aktuellen Sprache. one und other sind grammatische Kategorien. Wenn du ein übersetztes Substantiv an eine formatierte Zahl anhängst, gehen diese Auswahl und die Möglichkeit verloren, die Wortreihenfolge zu ändern.

Die Hilfsfunktion plural erstellt benannte CLDR-Kategorien, enthält aber keine Zweige für exakte Zahlen wie =0. Verwende für eine produktspezifische Nachricht bei einer Anzahl von null den Textpfad mit einem expliziten ICU-Ausdruck:

ts
l.text("{count, plural, =0 {No items} one {# item} other {# items}}", {
  context: "Cart count with a distinct empty state",
  values: { count },
});

Zielsprachen können mehr Kategorien benötigen als Englisch. Sieh dir die übersetzte Nachricht an und teste die Formen, die die jeweilige Sprache auswählt, statt jede Sprache in die Zweige der Ausgangssprache zu zwängen. Pluralformen und Auswahlausdrücke beschreibt die unterstützten Formen und das Verhalten bei der Extraktion.

Verwende für eine semantische Alternative stabile Auswahlwerte:

ts
l.select(role, {
  admin: "Manage team settings",
  member: "View team settings",
  other: "View settings",
}, { context: "Settings action for the user's team role" });

Die Anwendung liefert role. Übersetze die Nachrichten in den Zweigen und behalte dabei admin, member sowie den erforderlichen Rückfallzweig other bei. Bei einem unbekannten Wert wird other verwendet.

Unterscheide Ordnungszahlen von Mengenangaben #

Eine Ordnungszahl beschreibt eine Position. Verwende für eine Nachricht wie die folgende den komplexen ICU-Formatierer des Textpfads:

ts
l.text("You finished {position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}", {
  context: "Participant's finishing position in a competition",
  values: { position },
});

Die Endungen gehören zum englischen Ausgangstext und folgen keiner allgemeingültigen Regel. Eine Übersetzung muss die Position in der jeweiligen Zielsprache ausdrücken. Die Übergabe von values aktiviert die Formatierung im Textpfad. Generierte Deklarationen kontrollieren die Anforderungen an den Aufruf, validieren aber nicht jeden verschachtelten ICU-Zweig.

Gib Währungs- und Prozenteinheiten ausdrücklich an #

Verwende numerische Beträge mit dem passenden Währungscode:

ts
const price = l.currency(1234.5, "EUR");
const discount = l.percent(0.15);

Der erste Aufruf formatiert Eurobeträge; er rechnet keine andere Währung in Euro um. Der zweite stellt fünfzehn Prozent dar, weil der Eingabewert ein Bruchteil ist. Die Übergabe von 15 würde eine andere Menge bedeuten. Wenn du diese formatierten Zeichenfolgen in einen Satz einfügst, übergib sie über benannte values, statt eine neue Ausgangszeichenfolge zu erstellen.

Die Formatierungshilfen unterstützen auch Zahlen, Einheiten, Listen und andere auf Intl basierende Werte. Sieh dir die Standardwerte und unterstützten Optionen jeder Hilfsfunktion an. Sprachabhängige Formatierung übersetzt nicht jede benutzerdefinierte Einheitenbezeichnung. Ungültige Optionen können weiterhin zu Fehlern führen.

Lege die Bedeutung des Datums und die Zeitzone für die Anzeige fest #

Ein Zeitstempel steht für einen Zeitpunkt; ein Kalenderdatum kann einen Tag ohne Zeitzone bezeichnen. Wandle eine Frist, die nur als Datum angegeben ist, nicht in einen Zeitpunkt um Mitternacht um, es sei denn, diese Umwandlung entspricht der Bedeutung im Produkt.

Gib für einen Zeitpunkt die gewünschte Zeitzone für die Anzeige an:

ts
const instant = new Date("2026-01-02T00:30:00Z");

const date = l.date(instant, { timeZone: "UTC" });
const time = l.time(instant, { timeZone: "UTC" });

Diese Hilfsfunktionen verwenden die aktive Sprache für die Darstellung und UTC als Zeitzone für die Anzeige. Du kannst die zugrunde liegenden Standard-APIs auch direkt verwenden:

ts
new Intl.NumberFormat("de-DE", {
  style: "currency", currency: "EUR",
}).format(1234.5);

new Intl.DateTimeFormat("en-US", {
  dateStyle: "medium", timeZone: "UTC",
}).format(new Date("2026-01-02T00:30:00Z"));

Nutze für Rich-Text-Nachrichten nur die unterstützte Grammatik #

l.rich ordnet benannte Tags React-Komponenten zu und interpoliert einfache Platzhalter. Der komplexe ICU-Formatierer von l.text kommt dabei nicht zum Einsatz. Ein Satz wie „Lies unsere <link>Lieferbedingungen</link> für {region}“ eignet sich für diesen Pfad, wenn der Code die Darstellung des Links und den Wert für die Region bereitstellt. Eine darin eingefügte Plural- oder Ordinalform wird dadurch nicht von ICU unterstützt.

Definiere Interaktionen weiterhin im Code und wähle eine unterstützte Nachrichtenstruktur, wenn Rich-Text-Struktur und Grammatik ineinandergreifen. Unbekannte Tags bleiben als wörtlicher Text erhalten. Bei verschachtelten Tags mit gleichem Namen ist die Zuordnung von öffnenden und schließenden Tags eingeschränkt. Siehe Interaktive Nachrichten mit Rich-Text.

Teste die Fälle, in denen sich die Bedeutung ändert #

Teste Anzahlen von 0, 1 und 2, eine größere Zahl sowie eine Dezimalzahl, sofern das Produkt dies zulässt. Berücksichtige bei englischen Ordnungszahlen 1, 2, 3, 11, 12, 13 und 21. Verwende für die Zielsprachen die jeweils erwarteten Formulierungen. Teste einen unbekannten Auswahlwert, negative Beträge, wo sie sinnvoll sind, und denselben Zeitpunkt in zwei Zeitzonen nahe Mitternacht.

Lade für diese Tests die tatsächlichen Zielsprachenkataloge. Bei einer fehlenden oder leeren Übersetzung kann die Ausgabe auf den Ausgangstext zurückfallen. Eine plausible Ausgabe allein belegt daher noch keine Abdeckung der Zielsprache. Vergleiche die ausgegebenen Werte mit der beabsichtigten Menge, dem Datum und der Nachricht. Führe anschließend eine Prüfung der sprachlichen Formulierung selbst durch.