← 返回首页
Date.UTC() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. Дата
  6. Date.UTC()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Date.UTC()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

Метод Date.UTC() принимает те же самые параметры, что и самая длинная форма конструктора Date и возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC.

In this article

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

const utcDate1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5)); const utcDate2 = new Date(Date.UTC(0, 0, 0, 0, 0, 0)); console.log(utcDate1.toUTCString()); // Expected output: "Fri, 02 Feb 1996 03:04:05 GMT" console.log(utcDate2.toUTCString()); // Expected output: "Sun, 31 Dec 1899 00:00:00 GMT"

Синтаксис

Начиная с ECMAScript 2017:

Date.UTC(year[, month[, day[, hour[, minute[, second[, millisecond]]]]]])

ECMAScript 2016 и ранее: (использование month обязательно)

Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]])

Параметры

year

Год, полностью.

month

Целое число между 0 и 11, представляющее месяц. (начиная с ES2017 необязательный параметр)

day Необязательный

Целое число между 1 и 31, представляющее дни месяца.

hour Необязательный

Целое число между 0 и 23, представляющее часы.

minute Необязательный

Целое число между 0 и 59, представляющее минуты.

second Необязательный

Целое число между 0 и 59, представляющее секунды.

millisecond Необязательный

Целое число между 0 и 999, представляющее миллисекунды.

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

Число, представляющее собой количество миллисекунд, прошедших с 1-ого Января 1970 года 00:00:00 UTC.

Описание

Метод UTC() принимает параметры даты, разделённые запятыми и возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC и указанным вами временем.

Для параметра year вы должны указать полный год; например, 1998. Если указан год между 0 и 99, метод преобразует год в год в 20-м веке (1900 + year); например, если вы указали 95, будет использоваться 1995 год.

Метод UTC() отличается от конструктора Date двумя вещами.

  • Метод Date.UTC() использует всемирное время вместо местного времени.
  • Метод Date.UTC() возвращает значение времени как число вместо создания объекта Date.

Если определённый вами параметр выходит за пределы ожидаемого диапазона, метод UTC() обновит другие параметры чтобы привести это число в ожидаемый диапазон. Например, если вы используете в качестве месяца число 15, год будет увеличен на 1 (year + 1), и в качестве месяца будет использоваться значение 3.

Поскольку метод UTC() является статическим методом объекта Date, вы всегда должны использовать его как Date.UTC().

Примеры

Пример: использование Date.UTC()

Следующее выражение создаёт объект Date, используя всемирное время вместо местного:

js
var utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

Спецификации

Specification
ECMAScript® 2027 Language Specification
# sec-date.utc

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

Enable JavaScript to view this browser compatibility table.

Примечание о совместимости

Date.UTC() с менее чем двумя аргументами

Когда вы предоставляете функции Date.UTC() меньше, чем два аргумента, то по стандартам ECMAScript 2017, она должна вернуть NaN. Браузерные движки, не поддерживающие подобное поведение, были обновлены (смотрите bug 1050755, ecma-262 #642).

js
Date.UTC(); Date.UTC(1); // Safari: NaN // Chrome/Opera/V8: NaN // Firefox <54: non-NaN // Firefox 54+: NaN // IE: non-NaN // Edge: NaN

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

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 17 февр. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. Date
  3. Конструктор
    1. Date()
  4. Статические методы
    1. Date.now()
    2. Date.parse()
    3. Date.UTC()
  5. Методы экземпляра
    1. Date.prototype.getDate()
    2. Date.prototype.getDay()
    3. Date.prototype.getFullYear()
    4. Date.prototype.getHours()
    5. Date.prototype.getMilliseconds()
    6. Date.prototype.getMinutes()
    7. Date.prototype.getMonth()
    8. Date.prototype.getSeconds()
    9. Date.prototype.getTime()
    10. Date.prototype.getTimezoneOffset()
    11. Date.prototype.getUTCDate()
    12. Date.prototype.getUTCDay()
    13. Date.prototype.getUTCFullYear()
    14. Date.prototype.getUTCHours()
    15. Date.prototype.getUTCMilliseconds()
    16. Date.prototype.getUTCMinutes()
    17. Date.prototype.getUTCMonth()
    18. Date.prototype.getUTCSeconds()
    19. Date.prototype.getYear()
    20. Date.prototype.setDate()
    21. Date.prototype.setFullYear()
    22. Date.prototype.setHours()
    23. Date.prototype.setMilliseconds()
    24. Date.prototype.setMinutes()
    25. Date.prototype.setMonth()
    26. Date.prototype.setSeconds()
    27. Date.prototype.setTime()
    28. Date.prototype.setUTCDate()
    29. Date.prototype.setUTCFullYear()
    30. Date.prototype.setUTCHours()
    31. Date.prototype.setUTCMilliseconds()
    32. Date.prototype.setUTCMinutes()
    33. Date.prototype.setUTCMonth()
    34. Date.prototype.setUTCSeconds()
    35. Date.prototype.setYear()
    36. Date.prototype.toDateString()
    37. Date.prototype.toISOString()
    38. Date.prototype.toJSON()
    39. Date.prototype.toLocaleDateString()
    40. Date.prototype.toLocaleString()
    41. Date.prototype.toLocaleTimeString()
    42. Date.prototype.toString()
    43. toTemporalInstant()
    44. Date.prototype.toTimeString()
    45. Date.prototype.toUTCString()
    46. Date.prototype.valueOf()
    47. [Symbol.toPrimitive]()
  6. Наследование
  7. Object/Function
  8. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  9. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  10. Методы экземпляра
    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.toString()
    10. Object.prototype.valueOf()
  11. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.