Date.prototype.toUTCString()
Базовый уровень Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Метод toUTCString() экземпляров Date возвращает строку, представляющую эту дату в формате RFC 7231, с возможностью использования отрицательных годов. Временная зона всегда UTC. toGMTString() является псевдонимом этого метода.
Попробуйте
const event = new Date("14 Jun 2017 00:00:00 PDT");
console.log(event.toUTCString());
// Expected output: "Wed, 14 Jun 2017 07:00:00 GMT"
Синтаксис
toUTCString()
Параметры
Нет.
Возвращаемое значение
Строка, представляющая данную дату во временной зоне UTC (см. описание формата). Возвращает "Invalid Date", если дата недействительна.
Описание
Значение, возвращаемое toUTCString(), представляет собой строку в формате Www, dd Mmm yyyy HH:mm:ss GMT, где:
| Строка формата | Описание |
|---|---|
Www | День недели, в виде трех букв (например, Sun, Mon) |
dd | День месяца, в виде двух цифр с ведущим нулем при необходимости |
Mmm | Месяц, в виде трех букв (например, Jan, Feb) |
yyyy | Год, в виде четырех или более цифр с ведущими нулями при необходимости |
HH | Час, в виде двух цифр с ведущим нулем при необходимости |
mm | Минута, в виде двух цифр с ведущим нулем при необходимости |
ss | Секунды, в виде двух цифр с ведущим нулем при необходимости |
Псевдонимы
JavaScript API Date был вдохновлен библиотекой Java java.util.Date (хотя последняя стала де-факто устаревшей с Java 1.1 в 1997 году). В частности, класс Java Date имел метод toGMTString — который был плохо назван, поскольку среднее время по Гринвичу не эквивалентно Всемирному координированному времени, в то время как даты JavaScript всегда работают по времени UTC. По соображениям совместимости с веб-браузерами, toGMTString остается псевдонимом для toUTCString, и они ссылаются на один и тот же объект функции. Это означает:
Date.prototype.toGMTString.name === "toUTCString";
Примеры
Использование toUTCString()
const d = new Date(0); console.log(d.toUTCString()); // 'Thu, 01 Jan 1970 00:00:00 GMT'
Спецификации
Совместимость с браузерами
| Desktop | Mobile | Server | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | Bun | Deno | Node.js | |
toUTCString |
1 |
12 |
1 |
4 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
4.4 |
1 |
1.0.0 |
1.0 |
0.10.0 |
См. также
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toUTCString