Date.prototype.toUTCString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

Метод toUTCString() экземпляров Date возвращает строку, представляющую дату в формате RFC 7231, отрицательные значения допускаются. Временная зона всегда UTC. toGMTString() является синонимом этого метода.

Интерактивный пример

Синтаксис

js
toUTCString()

Параметры

Нет.

Возвращаемое значение

Строка, представляющая дату, используя временную зону UTC (смотрите описание формата). Возвращает "Invalid Date" если дата недопустима.

Описание

Значение, возвращаемое методом toUTCString(), является строкой в формате Www, dd Mmm yyyy HH:mm:ss GMT, где:

Строка Значение
Www День недели в виде трёх букв (например, Sun, Mon)
dd День месяца в виде двух цифр, с ведущим нулём, если требуется
Mmm Месяц в виде трёх букв (например, Jan, Feb)
yyyy Год в виде четырёх или более цифр с ведущими нулями, если требуется
HH Час в виде двух цифр с ведущим нулём если требуется
mm Минута в виде двух цифр с ведущим нулём если требуется
ss Секунды в виде двух цифр с ведущим нулём, если требуется

Псевдонимы

Date API в JavaScript был создан под влиянием библиотеки java.util.Date из языка Java (которая впоследствии стала устаревшей, начиная с версии Java 1.1 в 1997 году). В частности, у класса Date в Java есть метод toGMTString, который был неудачно назван, потому что Среднее время по Гринвичу не эквивалентно Всемирному координированному времени, тогда как даты в JavaScript оперируют временем UTC. В целях совместимости toGMTString остаётся псевдонимом toUTCString, и они ссылаются на один и тот же объект. То есть:

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

Примеры

Использование 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

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также