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í #
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.
| Metoda | Parametry 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 #
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 #
| Metoda | Vý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.