CKTIS / JavaScript
Intl.PluralRules.prototype.select(): elegir una categoría de plural
`select(value)` devuelve la categoría gramatical de un valor según la configuración regional y las opciones de la instancia. El resultado sirve para elegir un mensaje traducido, no para formatear un número.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
rules.select(value)Intl.PluralRules.prototype.select es un método de instancia. Crea rules con new Intl.PluralRules(locales, options) y luego llama a rules.select(value). Devuelve una de las cadenas "zero", "one", "two", "few", "many" u "other". Las categorías disponibles dependen de la configuración regional efectiva y del tipo de regla; "one" no equivale siempre a value === 1. Usa la categoría como clave para elegir una variante traducida: el método no traduce texto ni formatea números.
El tipo predeterminado "cardinal" indica cantidad («¿cuántos?»); "ordinal" indica posición («¿en qué puesto?»). El redondeo y opciones de dígitos como minimumFractionDigits pueden cambiar la categoría, porque las reglas pueden depender de los dígitos decimales visibles. select clasifica un valor; selectRange clasifica un intervalo completo. Consulta rules.resolvedOptions().locale para saber qué configuración regional se usó realmente, ya que puede diferir de la solicitada.
El receptor (this) debe ser una instancia inicializada de Intl.PluralRules. Invocar el método sobre el propio prototipo o como función separada y sin vincular provoca TypeError. Tanto en la edición de 2024 de ECMA-402 como en el borrador actual, select usa ToNumber: las cadenas numéricas se convierten en valores de tipo Number ("2" se convierte en 2), mientras que BigInt y Symbol provocan TypeError. Si se omite el argumento, se convierte en NaN; NaN y ambos infinitos devuelven "other". Por tanto, obtener una categoría no valida la entrada.
Ejemplos
{
const cardinal = new Intl.PluralRules('en-US');
const ordinal = new Intl.PluralRules('en-US', { type: 'ordinal' });
const withFraction = new Intl.PluralRules('en-US', { minimumFractionDigits: 1 });
console.log(cardinal.select(1));
console.log(cardinal.select(2));
console.log(ordinal.select(2));
console.log(withFraction.select(1));
}Resultado
one other two other
Con las reglas del inglés estadounidense, `2` da `other` como cardinal y `two` como ordinal. Al exigir un dígito decimal, `1` se clasifica como `1.0`, por lo que devuelve `other` en lugar de `one`.
Lecciones relacionadas
- JavaScript · Lección 24 · Avanzado · Versión: 4
Fuentes
- ECMAScript® 2024 Internationalization API Specification — Intl.PluralRules.prototype.select
- ECMAScript® 2024 Internationalization API Specification — ResolvePlural
- ECMAScript® 2024 Language Specification — ToNumber
- ECMA-402 living draft — Intl.PluralRules.prototype.select
- MDN — Intl.PluralRules.prototype.select()
- MDN — Intl.PluralRules() constructor