Formátování hodnot pro daný jazyk

Formátujte čísla, data, seznamy a text pomocí nativního Intl a zadávejte jednotky a časové údaje potřebné pro zobrazení.

I přeložené zprávy obsahují hodnoty: ceny, data, množství a seznamy. Objekt Lingo tyto hodnoty formátuje podle svého aktivního jazyka, aniž by je vyhledával v katalogu. Použijte stejný objekt, který vykresluje okolní zprávu, aby se zpráva i hodnoty řídily stejným jazykem.

Čísla a množství #

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" });

Cena se formátuje ze zadané částky v amerických dolarech; k převodu měn nedochází. Vstupem pro procenta je poměr, takže 0.125 se zobrazí jako 12.5%, zatímco 12.5 by znamenalo 1250%. Stejně tak pomocná metoda pro jednotky doplní označení ke zadané hodnotě ve stupních Celsia, aniž by ji převáděla.

MetodaParametry za hodnotou
num(value: number)Nepovinné Intl.NumberFormatOptions.
currency(value: number, currency: string)Kód měny, poté nepovinné volby formátování čísel.
percent(value: number)Nepovinné volby formátování čísel.
unit(value: number, unit: string)Identifikátor jednotky, poté nepovinné volby formátování čísel.
compact(value: number)Nepovinné volby formátování čísel.
fileSize(bytes: number)Bez voleb.

Všechny metody vracejí řetězce. Metody pro měnu, procenta a jednotky vždy používají styl odpovídající svému názvu; compact po uplatnění ostatních voleb vždy použije kompaktní zápis.

fileSize dělí mocninami čísla 1024 a používá pevná označení B, KB, MB, GB, TB a PB. Číslo formátuje podle jazyka, u bajtů bez desetinných míst a u větších jednotek nejvýše s jedním desetinným místem. Hodnota 1024 se zobrazí jako 1 KB; nula jako 0 B. Zadejte nezáporný celočíselný počet bajtů. Pro záporné hodnoty a zlomky bajtů není stanoven smysluplný způsob zobrazení a označení jako GB se nepřekládají do francouzštiny jako Go.

Data, časy a relativní časové rozdíly #

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" });

Tato volání používají l z předchozího příkladu. date, time a datetime přijímají Date | number a poté nepovinné Intl.DateTimeFormatOptions. Číselná časová razítka se zadávají v milisekundách, nikoli v unixových sekundách. Výchozím nastavením je v uvedeném pořadí střední formát data, krátký formát času a kombinace obou.

Zadáním jednotlivých polí, například year nebo hour, se výchozí styly nepoužijí. Výslovně zadané volby stylu mohou přepsat výchozí nastavení, ale nekompatibilní kombinace stylů a jednotlivých polí mohou způsobit, že nativní Intl vyvolá výjimku. Pokud musí server i prohlížeč zobrazovat stejné datum, nastavte časové pásmo.

relative(value, unit, options?) přijímá číslo se znaménkem, Intl.RelativeTimeFormatUnit a nepovinné Intl.RelativeTimeFormatOptions. Formátuje zadaný časový rozdíl. Rozdíl vůči referenčnímu okamžiku vypočítejte v kódu aplikace a podle potřeby jej aktualizujte; metoda nezjišťuje aktuální čas ani neplánuje aktualizace.

Seznamy a práce s textem #

MetodaVýsledek a chování
list(items: string[], options?: Intl.ListFormatOptions)Řetězec spojující již vybrané popisky; ve výchozím nastavení se používá slučovací spojka.
displayName(code, type)Lokalizovaný název nebo undefined; typ je language, region, script nebo currency. Nativní náhradní řešení může vrátit samotný kód.
sort(items: string[], options?: Intl.CollatorOptions)Nové pole seřazené podle pravidel daného jazyka; vstup zůstává beze změny.
segment(text, granularity?)Segmenty řetězce s výchozím nastavením grapheme nebo s nastavením word/sentence. Režim dělení na slova zahrnuje i segmenty tvořené bílými znaky.

displayName zachytává chyby nativního API a vrací undefined. Ostatní metody chyby tímto způsobem nezachytávají. Kódy jazyků a volby ověřujte při vstupu do aplikace.

Zohledněte podporované běhové prostředí #

Tyto pomocné metody předávají zpracování nativním NumberFormat, DateTimeFormat, RelativeTimeFormat, ListFormat, DisplayNames, Collator a Segmenter. Balíček nenahrazuje chybějící nativní API ani nedodává jazyková data pro každé běhové prostředí.

Otestujte reprezentativní hodnoty na serveru i v podporovaných prohlížečích. Interpunkce a zvyklosti se mohou lišit podle dat ICU. Při hydrataci zajistěte kromě shodného jazyka také shodné časové razítko, časové pásmo a referenční okamžik pro relativní čas.