toLocaleString (Método)
Devuelve un valor como un valor de cadena apropiado para la configuración regional actual del entorno host.
function toLocaleString() : String
Comentarios
Para el objeto Array, los elementos de la matriz se convierten en cadenas y estas cadenas se concatenan y devuelven separadas entre sí por el separador de lista especificado para la configuración regional actual del entorno host.
Para el objeto Date, el método toLocaleString devuelve un objeto String que contiene la fecha escrita en el formato largo predeterminado de la configuración regional actual.
Para fechas comprendidas entre 1601 y 9999 d.C., se aplica formato a la fecha de acuerdo con la configuración regional del Panel de control del usuario.
Para fechas no incluidas dentro de este intervalo, se utiliza el formato predeterminado del método toString.
Para el objeto Number, toLocaleString genera un valor de cadena que representa el valor de Number con el formato apropiado para la configuración regional actual del entorno host.
Para objetos Object, el método ToLocaleString se proporciona para dar a todos los objetos una capacidad genérica toLocaleString, aunque no la utilicen.
Nota
El método toLocaleString sólo debe utilizarse para mostrar resultados al usuario; no debe utilizarse nunca como base para procesar datos dentro de un script, ya que el resultado devuelto depende del equipo.
Ejemplo
El siguiente ejemplo del lado cliente muestra el uso del método toLocaleString mediante un objeto Array, Date y Number.
function toLocaleStringArray() {
// Populate an array with values.
// Each value is the same as the index.
var myArray = new Array();
for(var i = 0; i <= 6; i++)
{
myArray[i] = i;
}
var s = myArray.toLocaleString();
return(s);
}
function toLocaleStringDate() {
var d = new Date();
var s = d.toLocaleString();
return(s);
}
function toLocaleStringNumber() {
var n = Math.PI;
var s = n.toLocaleString();
return(s);
}
Requisitos
Se aplica a:
Array (Objeto)| Date (Objeto)| Number (Objeto)| Object (Objeto)