Gestiona plurales, fechas y números

Deja que el idioma determine la gramática y el formato, mientras la aplicación mantiene el control de los valores, las unidades y las zonas horarias.

Al contar elementos hay que tomar dos decisiones: qué número representa la aplicación y cómo expresa esa cantidad el idioma de quien lee. Con las fechas y los importes ocurre lo mismo. Mantén los valores estructurados hasta mostrarlos para poder elegir de forma consciente la gramática, los separadores, la moneda y la zona horaria.

Estos ejemplos usan @lingo.dev/react. Los sistemas de recursos nativos tienen su propia sintaxis de mensajes y sus propios generadores; usar una notación similar a ICU no hace que todos los entornos de ejecución sean intercambiables.

Proporciona al formateador un mensaje completo #

En un componente dentro de LingoProvider, usa el recuento numérico con un mensaje de plural:

tsx
const l = useLingo();

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

Importa useLingo de @lingo.dev/react; count es el valor numérico de la aplicación. El entorno de ejecución construye un mensaje ICU y da formato a la traducción del catálogo según el idioma actual. one y other son categorías gramaticales. Concatenar un sustantivo traducido después de un número con formato impediría seleccionar la categoría correspondiente y cambiar el orden de las palabras.

La función auxiliar plural construye categorías CLDR con nombre; no incluye ramas para números exactos, como =0. Si necesitas un mensaje específico del producto para el valor cero, usa la vía de texto con una expresión ICU explícita:

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

Los idiomas de destino pueden necesitar más categorías que el inglés. Examina el mensaje traducido y prueba las formas que selecciona cada idioma, en lugar de obligar a todos los idiomas a usar las ramas del texto de origen. Plurales y selectores documenta las formas admitidas y el comportamiento de la extracción.

Para una alternativa semántica, usa valores de selector estables:

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

La aplicación proporciona role. Traduce los mensajes de las ramas y conserva admin, member y la alternativa obligatoria other. Si el valor es desconocido, se usa other.

Distingue la posición ordinal de la cantidad cardinal #

Un ordinal describe una posición. Usa el formateador ICU complejo de la vía de texto para un mensaje como este:

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

Los sufijos corresponden al texto de origen en inglés, no a una regla universal. La traducción de destino debe expresar la posición en su propio idioma. Proporcionar values permite aplicar formato en la vía de texto; las declaraciones generadas comprueban el contrato de llamada, pero no validan todas las ramas ICU anidadas.

Indica explícitamente las unidades de moneda y porcentaje #

Usa importes numéricos con el código de moneda correspondiente:

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

La primera llamada da formato al importe en euros; no convierte otra moneda a euros. La segunda representa un quince por ciento porque recibe una fracción como entrada. Proporcionar 15 representaría una cantidad distinta. Al insertar estas cadenas con formato en una frase, pásalas mediante values con nombre en lugar de crear una nueva cadena de origen.

Las funciones auxiliares de formato también permiten dar formato a números, unidades, listas y otros valores mediante Intl. Comprueba los valores predeterminados y las opciones admitidas de cada función auxiliar. El formato adaptado al idioma no traduce todas las etiquetas de unidades personalizadas, y las opciones no válidas pueden seguir provocando errores.

Elige qué representa la fecha y en qué zona horaria se muestra #

Una marca de tiempo representa un instante; una fecha de calendario puede representar un día sin zona horaria. No conviertas una fecha límite sin hora en un instante a medianoche, salvo que esa conversión refleje lo que la fecha significa en el producto.

Para un instante, especifica la zona horaria en la que quieres mostrarlo:

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

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

Estas funciones auxiliares usan el idioma activo para la presentación y UTC como zona horaria de visualización. También puedes utilizar directamente las API estándar subyacentes:

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

Limita los mensajes enriquecidos a la gramática que admiten #

l.rich asigna etiquetas con nombre a componentes de React e interpola marcadores de posición simples. No utiliza el formateador ICU complejo de l.text. Una frase como «Consulta nuestra <link>política de entrega</link> para {region}» funciona por esta vía cuando el código proporciona el renderizador del enlace y el valor de la región. Añadir un plural o un ordinal dentro del mensaje no habilita la compatibilidad con ICU.

Mantén las definiciones de interacción en el código y elige un diseño de mensaje compatible cuando se combinen una estructura enriquecida y la gramática. Las etiquetas desconocidas se mantienen como texto literal, y el emparejamiento de etiquetas anidadas con el mismo nombre tiene limitaciones. Consulta Mensajes interactivos enriquecidos.

Comprueba los casos en los que cambia el significado #

Prueba recuentos de 0, 1, 2, un número mayor y un decimal si el producto lo permite. Para los ordinales en inglés, incluye 1, 2, 3, 11, 12, 13 y 21; para los idiomas de destino, usa la redacción esperada en cada idioma. Prueba un selector desconocido, importes negativos cuando tengan sentido y el mismo instante en dos zonas horarias cerca de la medianoche.

Carga los catálogos reales de los idiomas de destino para estas comprobaciones. Si falta una traducción o está vacía, puede usarse el texto de origen como alternativa, por lo que un resultado que parezca correcto no basta para confirmar la cobertura del idioma de destino. Compara los valores mostrados con la cantidad, la fecha y el mensaje previstos y, después, haz una revisión del propio texto.