From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../object/tolocalestring/index.html | 115 +++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 files/pt-br/web/javascript/reference/global_objects/object/tolocalestring/index.html (limited to 'files/pt-br/web/javascript/reference/global_objects/object/tolocalestring/index.html') diff --git a/files/pt-br/web/javascript/reference/global_objects/object/tolocalestring/index.html b/files/pt-br/web/javascript/reference/global_objects/object/tolocalestring/index.html new file mode 100644 index 0000000000..4d857a21e4 --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/object/tolocalestring/index.html @@ -0,0 +1,115 @@ +--- +title: Object.prototype.toLocaleString() +slug: Web/JavaScript/Reference/Global_Objects/Object/toLocaleString +tags: + - JavaScript + - Method + - Object + - Objeto + - Prototipo + - Prototype + - Referencia + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Object/toLocaleString +--- +

{{JSRef}}

+ +

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.

+ +
{{EmbedInteractiveExample("pages/js/object-prototype-tolocalestring.html")}}
+ + + +

Sintaxe

+ +
obj.toLocaleString()
+ +

Valor de retorno

+ +

Uma string representando o objeto.

+ +

Descrição

+ +

toLocaleString do {{jsxref("Object")}} returna o resultado da chamada {{jsxref("Object.toString", "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 {{jsxref("Array")}}, {{jsxref("Array.toLocaleString", "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:

+ +
const testArray = [4, 7, 10];
+
+let euroPrices = testArray.toLocaleString('fr', { style: 'currency', currency: 'EUR'});
+// "4,00 €,7,00 €,10,00 €"
+ +

Sobrescrita do Date toLocaleString()

+ +

Em objetos {{jsxref("Date")}}, {{jsxref("Date.toLocaleString", "toLocaleString()")}} é usado para imprimir datas mais apropriadas para localizações específicas:

+ +

Por exemplo:

+ +
const testDate = new Date(Date.now());
+// "Date Fri May 29 2020 18:04:24 GMT+0100 (British Summer Time)"
+
+let deDate = testDate.toLocaleString('de');
+// "29.5.2020, 18:04:24"
+
+var frDate = testDate.toLocaleString('fr');
+//"29/05/2020 à 18:04:24"
+ +

Sobrescrita de Number toLocaleString()

+ +

Em objetos {{jsxref("Number")}}, {{jsxref("Number.toLocaleString", "toLocaleString()")}} é usado para imprimir números para localizações específicas, e.g. com os corretos separadores:

+ +

Por exemplo:

+ +
const testNumber = 2901234564;
+// "2901234564"
+
+let deNumber = testNumber.toLocaleString('de');
+// "2.901.234.564"
+
+let frNumber = testNumber.toLocaleString('fr');
+// "2 901 234 564"
+ +

Especificações

+ + + + + + + + + + + + +
Especificação
{{SpecName('ESDraft', '#sec-object.prototype.tolocalestring', 'Object.prototype.toLocaleString')}}
+ +

Compatibilidade de navegador

+ + + +

{{Compat("javascript.builtins.Object.toLocaleString")}}

+ +

Veja também

+ + -- cgit v1.2.3-54-g00ecf