JavaScript – Date toLocaleFormat() 方法

JavaScript 的 Date 对象是一个和时间相关的对象，可以用它来处理各种时间和日期操作，如日期格式化等。在 Date 对象中，toLocaleFormat() 是一个实用的方法，可以将日期格式化为指定的本地时间格式。

toLocaleFormat() 方法的使用

toLocaleFormat() 方法通过多个参数组合，展示一个符合本地格式的日期字符串。

以下是 toLocaleFormat() 方法的语法：

dateobject.toLocaleFormat(formatString);

其中，formatString 参数是必选项，表示指定的日期格式。formatString 的语法和格式是一般的 Date 对象不同的，可以根据实际需求灵活组合，下面是 formatString 的格式及含义：

字符	含义
%a	缩写的星期几名称（例如：Mon）
%A	完整的星期几名称（例如：Monday）
%b	缩写的月份名称（例如：Jan）
%B	完整的月份名称（例如：January）
%c	短日期和时间表示法
%d	月份中的天数（例如：25）
%H	小时(00-24)
%I	小时(00-12)
%j	年份中的日期（例如：1-365）
%m	月份（例如：01-12）
%M	分钟数（例如：00-59）
%p	显示上午或下午
%S	秒数（例如：00-59）
%w	星期中的天数（例如：0-6）
%W	一年中第几周
%x	按照本地格式显示的日期
%X	按照本地格式显示的时间
%y	年份的最后两位数字（例如：14）
%Y	年份的完整数字（例如：2014）
%Z	时区名称（例如：GMT）

下面是使用 toLocaleFormat() 方法进行日期格式化的示例代码：

var today = new Date();
var formatted = today.toLocaleFormat("%Y-%m-%d %H:%M:%S");
console.log(formatted);

在这个代码中，我们创建了一个 Date 对象 today，然后使用 toLocaleFormat() 方法将日期格式化为本地格式的字符串。我们将字符串保存在了 formatted 变量中，并使用 console.log() 方法输出到控制台。输出结果格式为：2019-09-05 10:30:45。

当然，toLocaleFormat() 方法还可以根据具体需求自定义格式化字符串，以输出符合需求的本地时间格式。

使用实例

下面是一些常用的日期格式化示例：

var today = new Date();
console.log(today.toLocaleFormat("%Y-%m-%d")); // 2019-09-05
console.log(today.toLocaleFormat("%Y/%m/%d")); // 2019/09/05
console.log(today.toLocaleFormat("%m/%d/%Y")); // 09/05/2019
console.log(today.toLocaleFormat("%B %d, %Y")); // September 05, 2019
console.log(today.toLocaleFormat("%A %B %d, %Y")); // Thursday September 05, 2019
console.log(today.toLocaleFormat("%H:%M:%S")); // 10:30:45
console.log(today.toLocaleFormat("%I:%M:%S %p")); // 10:30:45 AM

在这个示例代码中，我们创建了一个 Date 对象 today，然后使用了多种不同的 formatString 选项对日期进行了格式化，输出结果符合需求的本地时间格式。

其他注意事项

我们需要注意的是，toLocaleFormat() 方法具有一定的跨浏览器兼容性问题，不同的浏览器对于支持情况不同。在大多数情况下，toLocaleFormat() 可以在 Firefox 和 Safari 中无缝使用，但在 Chrome 和其他使用 WebKit 引擎的浏览器中，该方法已不再支持。

在面对这种情况时，我们可以使用现代化的 JavaScript 语法，如模板字符串来达到同样的效果：

const today = new Date();
const formatted = ` ${today.getFullYear()}-$ {(today.getMonth() + 1).toString().padStart(2, "0")}- ${today.getDate().toString().padStart(2, "0")}$ {today.getHours().toString().padStart(2, "0")}: ${today.getMinutes().toString().padStart(2, "0")}:$ {today.getSeconds().toString().padStart(2, "0")}`;
console.log(formatted);

在这个代码中，我们使用了 ES6 中新增的模板字符串，以及日期对象的一些相关方法（如 getFullYear、getMonth、getDate 等）来动态拼接得到符合需求的本地时间格式。

结论

Date 对象的 toLocaleFormat() 方法可以方便地将日期格式化为符合本地时间格式的字符串。我们可以使用多种不同的 formatString 选项进行组合，得到符合需求的本地时间格式字符串。然而，由于该方法具有一定的兼容性问题，在碰到支持该方法的浏览器时可以直接使用，而在没有支持该方法的浏览器时，我们可以使用模板字符串等现代化的 JavaScript 语法来达到同样的效果。