Dar formato a valores según el idioma
Da formato a números, fechas, listas y texto con Intl nativo, proporcionando las unidades y la información de tiempo necesarias para mostrarlos.
Los mensajes traducidos también contienen valores: precios, fechas, cantidades y listas. Un objeto Lingo les da formato según su idioma activo, sin buscarlos en un catálogo. Usa el mismo objeto que muestra el mensaje que los rodea para que ambos sigan el mismo idioma.
Números y cantidades #
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" });El precio da formato al importe proporcionado en dólares estadounidenses; no convierte monedas. El valor de entrada del porcentaje es una proporción, así que 0.125 se muestra como 12.5%, mientras que 12.5 representaría 1250%. Del mismo modo, la función auxiliar de unidades agrega la etiqueta al valor proporcionado en grados Celsius sin convertirlo.
| Método | Parámetros después del valor |
|---|---|
num(value: number) | Intl.NumberFormatOptions opcional. |
currency(value: number, currency: string) | Código de moneda, seguido de opciones de formato numérico opcionales. |
percent(value: number) | Opciones de formato numérico opcionales. |
unit(value: number, unit: string) | Identificador de unidad, seguido de opciones de formato numérico opcionales. |
compact(value: number) | Opciones de formato numérico opcionales. |
fileSize(bytes: number) | Sin opciones. |
Todos devuelven cadenas de texto. Los métodos de moneda, porcentaje y unidad aplican obligatoriamente el estilo indicado por su nombre; compact aplica la notación compacta después de aplicar las demás opciones.
fileSize divide entre potencias de 1024 y usa las etiquetas fijas B, KB, MB, GB, TB y PB. Da formato al número según el idioma, sin decimales para los bytes y con un máximo de uno para las unidades mayores. 1024 pasa a ser 1 KB; el cero se muestra como 0 B. Proporciona una cantidad de bytes que sea un número entero no negativo. No hay un criterio útil de visualización para los valores negativos ni las fracciones de byte, y las etiquetas como GB no se traducen al francés como Go.
Fechas, horas y diferencias de tiempo relativas #
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" });Estas llamadas usan el l del ejemplo anterior. date, time y datetime aceptan Date | number, seguido de Intl.DateTimeFormatOptions opcional. Las marcas de tiempo numéricas se expresan en milisegundos, no en segundos Unix. Sus formatos predeterminados son, respectivamente, fecha en formato medio, hora en formato corto y ambos.
Al proporcionar campos individuales como year o hour, se desactivan los estilos predeterminados. Las opciones de estilo explícitas pueden reemplazar los valores predeterminados, pero combinar estilos y campos individuales incompatibles puede hacer que Intl nativo lance una excepción. Define una zona horaria cuando un servidor y un navegador deban mostrar la misma fecha.
relative(value, unit, options?) acepta un número con signo, un Intl.RelativeTimeFormatUnit y Intl.RelativeTimeFormatOptions opcional. Da formato a la diferencia de tiempo que proporcionas. Calcula la diferencia respecto a un instante de referencia en el código de la aplicación y actualízala cuando sea necesario; el método no consulta el reloj ni programa actualizaciones.
Listas y operaciones de texto #
| Método | Resultado y comportamiento |
|---|---|
list(items: string[], options?: Intl.ListFormatOptions) | Una cadena de texto que une etiquetas ya seleccionadas; la conjunción es la opción predeterminada. |
displayName(code, type) | Un nombre localizado o undefined; el tipo es language, region, script o currency. El mecanismo alternativo nativo puede devolver el código mismo. |
sort(items: string[], options?: Intl.CollatorOptions) | Un nuevo arreglo ordenado según las reglas del idioma; el arreglo de entrada no se modifica. |
segment(text, granularity?) | Segmentos de una cadena de texto, con grapheme de forma predeterminada o word/sentence. El modo de palabras incluye segmentos de espacios en blanco. |
displayName captura errores nativos y devuelve undefined. Los demás métodos no capturan los errores de esa manera. Valida los códigos de idioma y las opciones al recibirlos en tu aplicación.
Adapta el uso al entorno de ejecución que admites #
Estas funciones auxiliares delegan en las API nativas NumberFormat, DateTimeFormat, RelativeTimeFormat, ListFormat, DisplayNames, Collator y Segmenter. El paquete no reemplaza las API nativas que faltan ni proporciona los datos de idioma de todos los entornos de ejecución.
Prueba valores representativos en el servidor y los navegadores que admites. La puntuación y las convenciones pueden variar según los datos de ICU. Para la hidratación, mantén consistentes la marca de tiempo, la zona horaria y la referencia de tiempo relativo, además del idioma.