CKTIS / JavaScript
Intl.PluralRules.prototype.select(): escolher uma categoria de plural
`select(value)` devolve a categoria gramatical de um valor segundo a configuração regional e as opções da instância. O resultado serve para escolher uma mensagem traduzida, não para formatar um número.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
rules.select(value)Intl.PluralRules.prototype.select é um método de instância. Cria rules com new Intl.PluralRules(locales, options) e chama rules.select(value). O método devolve uma das cadeias "zero", "one", "two", "few", "many" ou "other". As categorias disponíveis dependem da configuração regional efetiva e do tipo de regra; "one" não equivale sempre a value === 1. Usa a categoria como chave para escolher uma variante traduzida: o método não traduz texto nem formata números.
O tipo predefinido "cardinal" indica quantidade («quantos?»); "ordinal" indica posição («em que lugar?»). O arredondamento e opções como minimumFractionDigits podem alterar a categoria, pois as regras podem depender dos algarismos decimais visíveis. select classifica um único valor; selectRange classifica um intervalo completo. Consulta rules.resolvedOptions().locale para saber qual foi a configuração regional efetivamente usada, pois pode ser diferente da pedida.
O recetor (this) tem de ser uma instância inicializada de Intl.PluralRules. Chamar o método no próprio protótipo ou como função separada e sem associação à instância lança TypeError. Tanto na edição de 2024 da ECMA-402 como no rascunho atual, select usa ToNumber: as cadeias numéricas são convertidas em valores do tipo Number ("2" passa a 2), enquanto BigInt e Symbol provocam TypeError. Um argumento omitido passa a NaN; NaN e ambos os infinitos devolvem "other". Obter uma categoria não comprova, portanto, que o valor de entrada seja válido.
Exemplos
{
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
Com as regras do inglês dos EUA, `2` dá `other` como cardinal e `two` como ordinal. Exigir uma casa decimal faz com que `1` seja classificado como `1.0`, devolvendo `other` em vez de `one`.
Lições relacionadas
- JavaScript · Lição 24 · Avançado · Versão: 4
Fontes
- 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