Метод toLocaleString

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает значение в виде строки, соответствующей текущему языковому стандарту хост-среды.

function toLocaleString() : String

Заметки

Для объекта Array элементы массива преобразуются в строки, которые объединяются и возвращаются. Строки отделяются разделителем списка, указанным в текущем языковом стандарте хост-среды.

Для объекта Date метод toLocaleString возвращает объект String, который содержит дату, записанную в формате, принятом по умолчанию в текущем языковом стандарте.

Для дат в диапазоне от 1601 до 9999 года нашей эры даты форматируются в соответствии с региональными стандартами, установленными на панели управления пользователя.
Для дат за пределами этого диапазона используется формат метода toString по умолчанию.

Для объекта Number метод toLocaleString создает строку, которая представляет значение Number, отформатированное в соответствии с текущим языковым стандартом хост-среды.

Для объектов Object метод ToLocaleString используется с целью предоставления всем объектам универсальной возможности toLocaleString, даже если некоторые объекты могут ее не поддерживать.

Примечание.
Метод toLocaleString следует использовать только для отображения результатов для пользователя; его нельзя использовать в качестве основы для вычислений в сценарии, поскольку возвращаемый результат зависит от конкретного компьютера.

Метод toLocaleString следует использовать только для отображения результатов для пользователя; его нельзя использовать в качестве основы для вычислений в сценарии, поскольку возвращаемый результат зависит от конкретного компьютера.

Пример

В следующем примере клиентского кода демонстрируется использование метода toLocaleString для объектов Array, Date и Number.

function toLocaleStringArray() {
   // Declare variables.
   var myArray = new Array(6);
   var i;
   // Initialize string.
   var s = "The array contains: ";
   // Populate array with values.
   for(i = 0;i < 7; i++)
   {
      // Make value same as index.
      myArray[i] = i;
   }
   s += myArray.toLocaleString();
   return(s);
}
function toLocaleStringDate() {
   // Declare variables.
   var d = new Date();
   var s = "Current date setting is ";
   // Convert to current locale.
   s += d.toLocaleString();
   return(s);
}
function toLocaleStringNumber() {
   var n = Math.PI;
   var s = "The value of Pi is: ";
   s+= n.toLocaleString();
   return(s);
}

Требования

Версия 1

Применение:

Объект "Array"| Объект "Date"| Числовой Объект| Объект Object

См. также

Другие ресурсы

Методы

Поделиться через