Maneja plurales, fechas y números
Deja que el idioma determine la gramática y el formato, mientras la aplicación conserva el control de los valores, las unidades y las zonas horarias.
Un conteo de elementos implica dos decisiones: qué número representa la aplicación y cómo expresa esa cantidad el idioma de quien lee. Lo mismo ocurre con las fechas y los importes monetarios. Mantén los valores estructurados hasta el momento de mostrarlos para poder elegir de forma deliberada 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 vuelve intercambiables todos los entornos de ejecución.
Dale al formateador un mensaje completo #
En un componente dentro de LingoProvider, usa el conteo numérico con un mensaje de plural:
const l = useLingo();
const label = l.plural(
count,
{ one: "# item", other: "# items" },
{ context: "Number of items in the shopping cart" },
);Importa useLingo desde @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 formateado 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. Para un mensaje específico del producto cuando el valor es cero, usa la vía de texto con una expresión ICU explícita:
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 a usar las ramas del original. Plurales y selectores documenta las formas admitidas y el comportamiento de la extracción.
Para una alternativa semántica, usa valores de selector estables:
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:
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 original en inglés, no a una regla universal. La traducción debe expresar la posición en el idioma de destino. Proporcionar values habilita el formato en la vía de texto; las declaraciones generadas verifican el contrato de la llamada, pero no validan cada rama ICU anidada.
Mantén explícitas las unidades monetarias y porcentuales #
Usa importes numéricos con el código de moneda correspondiente:
const price = l.currency(1234.5, "EUR");
const discount = l.percent(0.15);La primera llamada da formato a un importe en euros; no convierte otra moneda a euros. La segunda representa el quince por ciento porque el valor de entrada es una fracción. Proporcionar 15 representaría una cantidad distinta. Al insertar estas cadenas formateadas en una oración, pásalas mediante values con nombre, en lugar de crear una nueva cadena de origen.
Las funciones auxiliares de formato también permiten trabajar con números, unidades, listas y otros valores basados en Intl. Revisa los valores predeterminados y las opciones admitidas por cada función auxiliar. El formato adaptado al idioma no traduce todas las etiquetas de unidades personalizadas, y las opciones no válidas pueden provocar errores.
Define 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 que solo indica el día en un instante a medianoche, a menos que esa conversión coincida con el significado previsto en el producto.
Para un instante, especifica la zona horaria en la que quieres mostrarlo:
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 usar directamente las API estándar subyacentes:
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"));Mantén los mensajes enriquecidos dentro de la gramática que admiten #
l.rich asocia etiquetas con nombre a componentes de React e interpola marcadores de posición simples. No usa el formateador ICU complejo de l.text. Una oración como “Lee nuestra <link>política de entrega</link> para {region}” funciona en esa vía cuando el código proporciona el renderizador del enlace y el valor de la región. Agregar un plural o un ordinal dentro de ella 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 conservan como texto literal, y el emparejamiento de etiquetas anidadas con el mismo nombre tiene limitaciones. Consulta Mensajes interactivos enriquecidos.
Revisa los casos en los que cambia el significado #
Prueba conteos 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; usa la redacción esperada para cada idioma de destino. 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 una traducción falta o está vacía, se puede recurrir al original, así que un resultado aparentemente correcto no demuestra por sí solo la cobertura del idioma de destino. Compara los valores mostrados con la cantidad, la fecha y el mensaje previstos; después, revisa la redacción en sí.