globalization.dateToString
Возвращает дату в формате строки согласно локали клиента и часовой пояс.
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
Описание
Возвращает отформатированную дату String
через value
свойств, доступных из объекта, переданного в качестве параметра дляsuccessCallback
.
Входящий date
параметр должен иметь типDate
.
Если есть ошибка форматирования даты, то errorCallback
выполняет с [GlobalizationError](GlobalizationError/globalizationerror.html)
объект в качестве параметра. Ожидаемый код ошибки[GlobalizationError](GlobalizationError/globalizationerror.html).FORMATTING\_ERROR
.
options
Параметр является необязательным, и его значения по умолчанию являются:
{formatLength:'short', selector:'date and time'}
options.formatLength
Может быть short
, medium
, long
, илиfull
.
options.selector
Может быть date
, time
илиdate and time
.
Поддерживаемые платформы
- Андроид
- WebWorks ежевики (OS 5.0 и выше)
- iOS
- Windows Phone 8
Быстрый пример
Если браузер настроен en\_US
языка, это выводит всплывающее диалоговое окно с текстом похож на date: 9/25/2012 4:21PM
с использованием параметров по умолчанию:
navigator.globalization.dateToString(
new Date(),
function (date) { alert('date: ' + date.value + '\n'); },
function () { alert('Error getting dateString\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
Полный пример
<!DOCTYPE HTML>
<html>
<head>
<title>dateToString Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
function checkDateString() {
navigator.globalization.dateToString(
new Date(),
function (date) {alert('date: ' + date.value + '\n');},
function () {alert('Error getting dateString\n');,
{formatLength:'short', selector:'date and time'}}
);
}
</script>
</head>
<body>
<button onclick="checkDateString()">Click for date string</button>
</body>
</html>
Windows Phone 8 причуды
-
formatLength
Вариант поддерживает толькоshort
иfull
значения.