Date.prototype.toUTCString()

Date 实例的 toUTCString() 方法返回以 RFC 7231 格式表示该日期的字符串,允许使用负年份。时区始终为 UTC。toGMTString() 是该方法的别名。

¥The toUTCString() method of Date instances returns a string representing this date in the RFC 7231 format, with negative years allowed. The timezone is always UTC. toGMTString() is an alias of this method.

Try it

语法

¥Syntax

js
toUTCString()

参数

¥Parameters

没有任何。

¥None.

返回值

¥Return value

使用 UTC 时区表示给定日期的字符串(请参阅格式说明)。如果日期是 invalid,则返回 "Invalid Date"

¥A string representing the given date using the UTC time zone (see description for the format). Returns "Invalid Date" if the date is invalid.

描述

¥Description

toUTCString() 返回的值是 Www, dd Mmm yyyy hh:mm:ss GMT 形式的字符串,其中:

¥The value returned by toUTCString() is a string in the form Www, dd Mmm yyyy hh:mm:ss GMT, where:

格式化字符串 描述
Www 星期几,由三个字母组成(例如 SunMon
dd 月份中的某一天,如果需要,为带前导零的两位数字
Mmm 月份,三个字母(例如 JanFeb
yyyy 年份,如果需要,为四位或更多位数字,并带有前导零
hh 小时,如果需要,为带前导零的两位数字
mm 分钟,如果需要,为带前导零的两位数字
ss 秒,如果需要,为带前导零的两位数字

混叠

¥Aliasing

JavaScript 的 Date API 受到 Java 的 java.util.Date 库的启发(而后者自 1997 年 Java 1.1 以来已成为事实上的遗产)。特别是,Java Date 类有一个名为 toGMTString 的方法,该方法的命名很糟糕,因为 格林威治标准时间 不等于 协调世界时,而 JavaScript 日期始终按 UTC 时间运行。出于 Web 兼容性原因,toGMTString 仍然作为 toUTCString 的别名,并且它们引用完全相同的函数对象。这意味着:

¥JavaScript's Date API was inspired by Java's java.util.Date library (while the latter had become de facto legacy since Java 1.1 in 1997). In particular, the Java Date class had a method called toGMTString — which was poorly named, because the Greenwich Mean Time is not equivalent to the Coordinated Universal Time, while JavaScript dates always operate by UTC time. For web compatibility reasons, toGMTString remains as an alias to toUTCString, and they refer to the exact same function object. This means:

js
Date.prototype.toGMTString.name === "toUTCString";

示例

¥Examples

使用 toUTCString()

¥Using toUTCString()

js
const d = new Date(0);
console.log(d.toUTCString()); // 'Thu, 01 Jan 1970 00:00:00 GMT'

规范

Specification
ECMAScript Language Specification
# sec-date.prototype.toutcstring

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看