在此页

• 句法
• 描述
• 范例
• Polyfill
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

非标
此特征是非标准的，且不在标准轨道中。不要在面向 Web 的生产站点中使用它：它不适用于每个用户。实现之间可能存在大的不兼容性，且行为将来可能改变。

The non-standard toLocaleFormat() method converts a date to a string using the specified formatting. Intl.DateTimeFormat is an alternative to format dates in a standards-compliant way. See also the newer version of Date.prototype.toLocaleDateString() .

This feature has been removed and will no longer work in Firefox 58+. 见 Warning: Date.prototype.toLocaleFormat is deprecated for more information and migration help.

句法

dateObj.toLocaleFormat(formatString)
					

参数

formatString

A format string in the same format expected by the strftime() function in C.

返回值

A string representing the given date using the specified formatting.

描述

toLocaleFormat() method provides greater software control over the formatting of the generated date and/or time. Names for months and days of the week are localized using the operating system's locale. However, ordering of the day and month and other localization tasks are not handled automatically since you have control over the order in which they occur. You should take care that the format string is localized properly according to the user's system settings. Be aware that the locale used is not necessarily the same as the locale of the browser.

Extension and XULRunner developers should know that just loading the format string from a .dtd or .properties file using a chrome:// somedomain /locale/ somefile.ext URI should be avoided , as the .dtd / .properties file and the toLocaleFormat() method does not not necessarily use the same locale, which could result in odd looking or even ambiguous or unreadable dates.

Also note that the behavior of the used locale depends on the platform, and the user might customize the locale used, so using the system locale the choose the format string might in some cases not even be adequate. You might consider using some of the more general toLocale* methods of the Date object or doing your own custom localization of the date to be displayed using some of the get* methods of the Date object instead of using this method.

范例

使用 toLocaleFormat()

var today = new Date();
var date = today.toLocaleFormat('%A, %B %e, %Y');
					

在此范例中， toLocaleFormat() returns a string such as "Wednesday, October 3, 2007". Note that the format string in this example is not properly localized, which will result in the problems described above.

Polyfill

当使用 DateJS library you can polyfill Date.prototype.toLocaleDateString() like this:

if (!Date.prototype.toLocaleFormat) {
    (function() {
        Date.prototype.toLocaleFormat = function(formatString) {
            return this.format(formatString);
        };
    }());
}
					

规范

Not part of any standard.

浏览器兼容性

Not supported in any browser. Previously supported in Firefox 1.5 until Firefox 57 (January 2018).

另请参阅

• Intl.DateTimeFormat
• Date.prototype.toLocaleString()
• Date.prototype.toLocaleDateString()
• Date.prototype.toLocaleTimeString()

元数据

• 最后修改： May 19, 2020

相关话题

1. 标准内置对象
2. Archive
3. 继承：
4. Function
5. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
6. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
7. Object
8. 特性
   1. Object.prototype.__proto__
   2. Object.prototype.constructor
9. 方法
   1. Object.prototype.__defineGetter__()
   2. Object.prototype.__defineSetter__()
   3. Object.prototype.__lookupGetter__()
   4. Object.prototype.__lookupSetter__()
   5. Object.prototype.hasOwnProperty()
   6. Object.prototype.isPrototypeOf()
   7. Object.prototype.propertyIsEnumerable()
   8. Object.prototype.toLocaleString()
   9. Object.prototype.toSource()
   10. Object.prototype.toString()
   11. Object.prototype.valueOf()
   12. Object.setPrototypeOf()