Werte für eine Sprache formatieren

Formatiere Zahlen, Datumsangaben, Listen und Text mit nativem Intl und gib die Einheiten und Zeitinformationen an, die die Anzeige benötigt.

Auch übersetzte Nachrichten enthalten Werte: Preise, Datumsangaben, Mengen und Listen. Ein Lingo-Objekt formatiert diese Werte anhand seiner aktiven Sprache, ohne sie in einem Katalog nachzuschlagen. Verwende dafür dasselbe Objekt, das auch die umgebende Nachricht rendert, damit beide dieselbe Sprache verwenden.

Zahlen und Mengen #

ts
import { createLingo } from "@lingo.dev/react";

const l = createLingo("en-US");
const price = l.currency(29.99, "USD");
const completion = l.percent(0.125, { maximumFractionDigits: 1 });
const temperature = l.unit(32, "celsius", { unitDisplay: "long" });

Die Preisformatierung formatiert den angegebenen Betrag in US-Dollar, rechnet aber keine Währungen um. Die Eingabe für Prozentwerte ist ein Verhältnis: 0.125 wird als 12.5% angezeigt, während 12.5 einem Wert von 1250% entsprechen würde. Ebenso versieht die Hilfsfunktion für Einheiten den angegebenen Celsiuswert mit einer Einheitenbezeichnung, ohne ihn umzurechnen.

MethodeParameter nach dem Wert
num(value: number)Optional: Intl.NumberFormatOptions.
currency(value: number, currency: string)Währungscode, danach optionale Zahlenformatierungsoptionen.
percent(value: number)Optionale Zahlenformatierungsoptionen.
unit(value: number, unit: string)Einheitenkennung, danach optionale Zahlenformatierungsoptionen.
compact(value: number)Optionale Zahlenformatierungsoptionen.
fileSize(bytes: number)Keine Optionen.

Alle Methoden geben Zeichenfolgen zurück. Die Methoden für Währungen, Prozentwerte und Einheiten erzwingen den jeweils zugehörigen Stil; compact erzwingt die kompakte Schreibweise, nachdem die übrigen Optionen angewendet wurden.

fileSize dividiert durch Potenzen von 1024 und verwendet die festen Bezeichnungen B, KB, MB, GB, TB und PB. Die Zahl wird entsprechend der Sprache formatiert: bei Bytes ohne Nachkommastellen, bei größeren Einheiten mit höchstens einer. 1024 wird zu 1 KB; null wird als 0 B dargestellt. Gib die Anzahl der Bytes als nicht negative ganze Zahl an. Für negative Werte und Bruchteile von Bytes gibt es keine sinnvolle Darstellungsregel, und Bezeichnungen wie GB werden nicht ins französische Go übersetzt.

Datumsangaben, Uhrzeiten und relative Zeitabstände #

ts
const instant = new Date("2026-10-10T12:00:00Z");
const timestamp = l.datetime(instant, { timeZone: "UTC" });
const date = l.date(instant, {
  year: "numeric",
  month: "2-digit",
  day: "2-digit",
  timeZone: "UTC",
});
const age = l.relative(-3, "day", { numeric: "auto" });

Diese Aufrufe verwenden l aus dem vorherigen Beispiel. date, time und datetime akzeptieren Date | number, gefolgt von optionalen Intl.DateTimeFormatOptions. Numerische Zeitstempel werden in Millisekunden angegeben, nicht in Unix-Sekunden. Standardmäßig verwenden die Methoden ein mittleres Datumsformat, ein kurzes Uhrzeitformat beziehungsweise eine Kombination aus beiden.

Wenn du einzelne Felder wie year oder hour angibst, werden die Standardstile nicht angewendet. Explizite Stiloptionen können die Standardwerte überschreiben. Inkompatible Kombinationen aus Stilen und einzelnen Feldern können jedoch dazu führen, dass das native Intl eine Ausnahme auslöst. Lege eine Zeitzone fest, wenn Server und Browser dasselbe Datum anzeigen müssen.

relative(value, unit, options?) akzeptiert eine Zahl mit Vorzeichen, ein Intl.RelativeTimeFormatUnit und optionale Intl.RelativeTimeFormatOptions. Die Methode formatiert den von dir angegebenen Zeitabstand. Berechne die Differenz zu einem Referenzzeitpunkt im Anwendungscode und aktualisiere sie bei Bedarf; die Methode liest weder die aktuelle Uhrzeit aus noch plant sie Aktualisierungen.

Listen und Textoperationen #

MethodeErgebnis und Verhalten
list(items: string[], options?: Intl.ListFormatOptions)Eine Zeichenfolge, die bereits ausgewählte Bezeichnungen verbindet; standardmäßig mit einer Konjunktion.
displayName(code, type)Ein lokalisierter Name oder undefined; der Typ ist language, region, script oder currency. Die native API kann als Ersatz den Code selbst zurückgeben.
sort(items: string[], options?: Intl.CollatorOptions)Ein neues Array, geordnet nach den Sortierregeln der Sprache; die Eingabe bleibt unverändert.
segment(text, granularity?)Segmente einer Zeichenfolge, standardmäßig mit grapheme oder alternativ mit word/sentence. Der Wortmodus enthält auch Segmente aus Leerraumzeichen.

displayName fängt native Fehler ab und gibt undefined zurück. Die anderen Methoden fangen Fehler nicht auf diese Weise ab. Validiere Sprachcodes und Optionen dort, wo sie in deine Anwendung gelangen.

Auf die unterstützte Laufzeitumgebung abstimmen #

Diese Hilfsfunktionen greifen auf die nativen APIs NumberFormat, DateTimeFormat, RelativeTimeFormat, ListFormat, DisplayNames, Collator und Segmenter zurück. Das Paket ersetzt keine fehlenden nativen APIs und stellt nicht für jede Laufzeitumgebung die Sprachdaten bereit.

Teste repräsentative Werte auf dem Server und in den Browsern, die du unterstützt. Zeichensetzung und Konventionen können je nach ICU-Daten variieren. Achte bei der Hydration darauf, dass neben der Sprache auch der Zeitstempel, die Zeitzone und der Referenzzeitpunkt für relative Zeitangaben übereinstimmen.