Object.prototype.toLocaleString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
O método toLocaleString() retorna uma cadeia de caracteres (string) representando o objeto. Este método é feito para ser sobrescrito por objetos derivados para propósitos de localização específica.
Experimente
Sintaxe
obj.toLocaleString()
Valor de retorno
Uma string representando o objeto.
Descrição
toLocaleString do Object retorna o resultado da chamada toString().
Esta função é provida para dar aos objetos um método toLocaleString genérico, mesmo que nem todos os usem. Veja a lista abaixo.
Objetos sobrescrevendo toLocaleString
Exemplos
Sobrescrita do Array toLocaleString()
Em objetos Array, toLocaleString() pode ser usado para imprimir valores do arranjo como uma string, opcionalmente com identificadores de localização específicos (como símbolos monetários) atrelados a eles:
Por exemplo:
Sobrescrita do Date toLocaleString()
Em objetos Date, toLocaleString() é usado para imprimir datas mais apropriadas para localizações específicas:
Por exemplo:
Sobrescrita de Number toLocaleString()
Em objetos Number, toLocaleString() é usado para imprimir números para localizações específicas, e.g. com os corretos separadores:
Por exemplo:
Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.prototype.tolocalestring |