1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
---
title: Object.prototype.toLocaleString()
slug: Web/JavaScript/Reference/Global_Objects/Object/toLocaleString
translation_of: Web/JavaScript/Reference/Global_Objects/Object/toLocaleString
original_slug: Web/JavaScript/Referencia/Objetos_globales/Object/toLocaleString
---
<div>{{JSRef}}</div>
<p>El método <code><strong>toLocaleString()</strong></code> devuelve un string que representa a un objeto. Este método está pensado para ser redefinido en los objetos derivados, para los propósitos específicos de cada configuración regional.</p>
<div>{{EmbedInteractiveExample("pages/js/object-prototype-tolocalestring.html")}}</div>
<h2 id="Sintaxis">Sintaxis</h2>
<pre class="syntaxbox notranslate"><var>objeto</var>.toLocaleString()</pre>
<h3 id="Valor_de_retorno">Valor de retorno</h3>
<p>Un string que representa al objeto.</p>
<h2 id="Descripción">Descripción</h2>
<p>{{jsxref("Object")}}'s <code>toLocaleString</code> devuelve el resultado de llamar a {{jsxref("Object.toString", "toString()")}}.</p>
<p>Se proporciona esta función para que los objetos dispongan de un método <code>toLocaleString</code> genérico, aunque puede que no todos la utilicen. Véase la lista siguiente.</p>
<h3 id="Objetos_que_redefinen_toLocaleString">Objetos que redefinen <code>toLocaleString</code></h3>
<ul>
<li>{{jsxref("Array")}}: {{jsxref("Array.prototype.toLocaleString()")}}</li>
<li>{{jsxref("Number")}}: {{jsxref("Number.prototype.toLocaleString()")}}</li>
<li>{{jsxref("Date")}}: {{jsxref("Date.prototype.toLocaleString()")}}</li>
<li>{{jsxref("TypedArray")}}: {{jsxref("TypedArray.prototype.toLocaleString()")}}</li>
<li>{{jsxref("BigInt")}}: {{jsxref("BigInt.prototype.toLocaleString()")}}</li>
</ul>
<h2 id="Ejemplos">Ejemplos</h2>
<h3 id="Redefinición_de_toLocaleString_en_Array">Redefinición de toLocaleString() en Array</h3>
<p>En los objetos <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a></code> se puede utilizar <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toLocaleString">toLocaleString()</a></code> para imprimir los valores del <em>array</em> como un string, con indicadores opcionales de configuración regional (como símbolos de moneda) aplicados.</p>
<p>Por ejemplo:</p>
<pre class="brush: js notranslate">const unArray = [4, 7, 10];
let preciosEnEuros = unArray.toLocaleString('fr', { style: 'currency', currency: 'EUR'});
// "4,00 €,7,00 €,10,00 €"</pre>
<h3 id="Redefinición_de_toLocaleString_para_Date">Redefinición de toLocaleString() para Date</h3>
<p>En los objetos <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code> se usa <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString">toLocaleString()</a></code> para imprimir fechas en un formato adecuado a la configuración regional.</p>
<p>Por ejemplo:</p>
<pre class="brush: js notranslate">const unaFecha = new Date(Date.now());
// <span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="objectBox"><span class="objectTitle">"</span>2020-07-07T19:51:44.046Z<span class="Date">"
</span></span></span></span></span>let fechaAleman = unaFecha.toLocaleString('de');
// "7.7.2020, 21:55:22"
var fechaFrances= unaFecha.toLocaleString('fr');
//"07/07/2020 à 21:55:22"</pre>
<h3 id="Redefinición_de_toLocaleString_para_Number">Redefinición de toLocaleString() para Number</h3>
<p>En los objetos <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">Number</a></code> se usa <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString">toLocaleString()</a></code> para imprimir números de forma adecuada a la configuración regional, p. ej. para usar los separadores de miles correctos.</p>
<p>Por ejemplo:</p>
<pre class="brush: js notranslate">const unNumero = 2901234564;
// <span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="objectBox objectBox-number">"2901234564"
</span></span></span></span>let numeroAleman = unNumero.toLocaleString('de');
// "2.901.234.564"
let numeroFrances = unNumero.toLocaleString('fr');
// "2 901 234 564"</pre>
<h2 id="Especificaciones">Especificaciones</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Especificación</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('ESDraft', '#sec-object.prototype.tolocalestring', 'Object.prototype.toLocaleString')}}</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidad_con_navegadores">Compatibilidad con navegadores</h2>
<p>{{Compat("javascript.builtins.Object.toLocaleString")}}</p>
<h2 id="Ver_también">Ver también</h2>
<ul>
<li>{{jsxref("Object.prototype.toString()")}}</li>
</ul>
|
