Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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