Método JavaScript Object.prototype.toLocaleString()

El método Object.prototype.toLocaleString() devuelve una representación de string específica local de este objeto utilizando la configuración regional del entorno. Los objetos derivados como una array , un número, una fecha, un tipo de array y BigInt pueden anular este método.

Sintaxis:

object.toLocaleString()

Valor devuelto: Devuelve una representación de string de este objeto.

Objetos que anulan toLocaleString():

1. Array to Array.prototype.toLocaleString() : Devuelve una representación de string de este objeto de array.

Ejemplo:

// User inputs.
var name = [ "sahil", "zain", "deepanshu" ];
var number1 = 3.45;
var number2 = [ 23, 34, 54 ];
 
var arr = [ name, number1, number2 ];
   
// Applying array.toLocaleString function
var string = arr.toLocaleString();
   
// Printing string.
console.log(string);

Producción:

"sahil, zain, deepanshu, 3.45, 23, 34, 54"

2. BigInt a BigInt.prototype.toLocaleString() : Devuelve una representación de string de este objeto BigInt.

Ejemplo:

var Big = 45334n;
console.log(Big.toLocaleString());
 
Big =78753456789123456789n;
console.log(Big.toLocaleString('de-DE'));

Producción:

"45, 334"
"78.753.456.789.123.456.789"

3. Date to Date.prototype.toLocaleString() : Devuelve una representación de string de este objeto de fecha.

Ejemplo:

var d = new Date(Date.UTC(2020, 9, 26, 7, 0, 0));
var result = d.toLocaleString();
   console.log("Date and Time of apocalypse: "+ result);

Producción:

Date and Time of apocalypse: 26/10/2020, 12:30:00

4. Number to Number.prototype.toLocaleString() : Devuelve una representación de string de este número.

Ejemplo:

// Declaring an variable
  var a = new Number(159900);
   
  // Creating an dictionary like object and
  // include currency and style
  var myObj = {
    style: "currency",
    currency: "EUR"
  }
   
  console.log(a.toLocaleString("en-GB", myObj));

Producción:

€159,900.00

5. TypedArray a TypedArray.prototype.toLocaleString() :  Devuelve una string que representa el elemento de typedArray.

Ejemplo:

var geek = new Uint32Array([100, 897, 123, 132, 22]);
   
console.log(geek.toLocaleString());
   
console.log(geek.toLocaleString('en-US'));
   
console.log(geek.toLocaleString('hi',
    { style: 'currency', currency: 'HIR' }));

Producción:

"100, 897, 123, 132, 22"
"100, 897, 123, 132, 22"
"HIR 100.00, HIR 897.00, HIR 123.00, HIR 132.00, HIR 22.00"

Navegadores compatibles:

• Google Chrome 1 y superior
• Internet Explorer 5.5 y superior
• Firefox 1 y superior
• Apple Safari 1 y superior
• Ópera 4 y superior
• Borde 12 y superior