---
title: Date.UTC()
slug: Web/JavaScript/Reference/Global_Objects/Date/UTC
tags:
  - UTC
  - Дата
  - Довідка
  - Час Unix
translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC
---
<div>{{JSRef}}</div>

<p>Метод <strong><code>Date.UTC()</code></strong> приймає той самий перелік параметрів, що й найдовша форма конструктора {{jsxref("Date")}}, та повертає кількість мілісекунд між 00:00:00 першого січня 1970 року та миттю у часі (за UTC), що відповідає переданим параметрам.</p>

<div>{{EmbedInteractiveExample("pages/js/date-utc.html")}}</div>

<p class="hidden">Першокод цього прикладу збережено у репозиторії GitHub. Якщо ви хочете долучитися до створення чи поліпшення таких прикладів, пропонуйте нам свої зміни до репозиторію <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a>.</p>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox notranslate">Date.UTC(<var>year</var>, <var>month</var>[, <var>day</var>[, <var>hour</var>[, <var>minute</var>[, <var>second</var>[, <var>millisecond</var>]]]]])</pre>

<h3 id="Параметри">Параметри</h3>

<dl>
 <dt><code>year</code></dt>
 <dd>Ціле число, що позначає рік. Значення в проміжку 0-99 позначає рік 20-го сторіччя (1900-1999), а всі решта значень — як є (абсолютне значення).</dd>
 <dt><code>month</code></dt>
 <dd>Ціле число між 0 та 11, позначає місяць.</dd>
 <dt><code>day </code>{{optional_inline}}</dt>
 <dd>Ціле число між 1 та 31, позначає день місяця.</dd>
 <dt><code>hour </code>{{optional_inline}}</dt>
 <dd>Ціле число між 0 та 23, позначає годину.</dd>
 <dt><code>minute </code>{{optional_inline}}</dt>
 <dd>Ціле число між 0 та 59, позначає хвилини.</dd>
 <dt><code>second </code>{{optional_inline}}</dt>
 <dd>Ціле число між 0 та 59, позначає секунди.</dd>
 <dt><code>millisecond </code>{{optional_inline}}</dt>
 <dd>Ціле число між 0 та 999, позначає мілісекунди.</dd>
</dl>

<h3 id="Повертає">Повертає</h3>

<p>Ціле число, що являє собою кількість мілісекунд між 00:00:00 першого січня 1970 року та моментом часу (за UTC), що відповідає переданим параметрам.</p>

<h2 id="Опис">Опис</h2>

<p>Метод приймає параметри, що позначають окремі складники дати й часу, та повертає кількість мілісекунд між північчю (00:00:00) першого січня 1970-го року за UTC та вказаною миттю у часі. Всі дати раніше за точку відліку (перше січня 1970-го року) позначаються від'ємними числами.</p>

<p>Зауважте, що лік місяців (другий параметр метода) починається з нуля, а не з одиниці.</p>

<p>Вказуйте повний рік від Різдва Христового; наприклад 1998. Якщо вказано значання між 0 та 99, його буде перетворено на рік 20-го сторіччя (себто 1900 + year); наприклад, 91 позначає 1991 рік.</p>

<p>Між методом <code>UTC()</code> та конструктором <code>{{jsxref("Date")}}</code> є дві відмінності:</p>

<ul>
 <li><code>Date.UTC()</code> використовує всесвітній (UTC), а не місцевий час;</li>
 <li><code>Date.UTC()</code> повертає числове значення, а не об'єкт <code>{{jsxref("Date")}}</code>.</li>
</ul>

<div class="note">
<p><strong>Заувага:</strong> Якщо значення одного чи декількох вказаних складників виходить за прийнятні межі (скажімо, вказано 13-й місяць чи 70 хвилин), буде скориговано суміжні складники. Себто виклик <code>Date.UTC(2013, 13, 1)</code> є тотожним до <code>Date.UTC(2014, 1, 1)</code> і так само відповідає даті <code>2014-02-01T00:00:00Z</code>. Те саме стосується інших значень: виразам <code>Date.UTC(2013, 2, 1, 0, 70)</code> та <code>Date.UTC(2013, 2, 1, 1, 10)</code> однаково відповідає дата <code>2013-03-01T01:10:00Z</code>.</p>
</div>

<p>Позаяк <code>UTC()</code> є статичним методом класу <code>{{jsxref("Date")}}</code>, він зазвичай викликається через ім'я класу — <code>Date.UTC()</code>, а не через наявний об'єкт.</p>

<h2 id="Приклади">Приклади</h2>

<h3 id="Використання_Date.UTC">Використання <code>Date.UTC()</code></h3>

<p>Наведений приклад створює об'єкт типу <code>{{jsxref("Date")}}</code> зі складників дати й часу, що тлумачаться як UTC, а не місцевий час:</p>

<pre class="brush:js notranslate">var independenceDateAsMs = Date.UTC(91, 7, 24, 9, 0, 0);
console.log(independenceDateAsMs);  // 683024400000

var independenceDate = new Date(independenceDateAsMs);
console.log(independenceDate);  // Sat Aug 24 1991 12:00:00 GMT+0300 (EEST)
</pre>

<p>Такий приклад засвідчує, що дати раніше точки відліку (північ першого січня 1970-го року) позначаються від'ємними числами:</p>

<pre class="brush: js notranslate">var ms = Date.UTC(1969, 11, 31, 23, 59, 59, 999);
console.log(ms);  // -1</pre>

<h2 id="Специфікації">Специфікації</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Специфікація</th>
   <th scope="col">Статус</th>
   <th scope="col">Коментар</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-date.utc', 'Date.UTC')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('ES1')}}</td>
   <td>{{Spec2('ES1')}}</td>
   <td>Початкова виознака. Запроваджено у JavaScript 1.0.</td>
  </tr>
 </tbody>
</table>

<h2 id="Підтримка_веб-переглядачами">Підтримка веб-переглядачами</h2>

<div class="hidden">Таблиця сумісності на цій сторінці створена зі структурованих даних. Якщо ви хочете долучитися до розробки цих даних, пропонуйте нам свої pull request до репозиторію <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div>

<p>{{Compat("javascript.builtins.Date.UTC")}}</p>

<h2 id="Сумісність">Сумісність</h2>

<h3 id="Відсутність_обовязкових_аргументів_Date.UTC">Відсутність обов'язкових аргументів <code>Date.UTC</code></h3>

<p>За відсутності одного чи обох обов'язкових аргументів метод <code>Date.UTC</code> має повертати <code>{{Glossary("NaN")}}</code>. Така поведінка визначена специфікацією ECMAScript 2017. Web-рушії, які не підтримували цю поведінку, було оновлено (див. {{bug(1050755)}}, <a href="https://github.com/tc39/ecma262/pull/642">ecma-262 #642</a>).</p>

<pre class="brush: js notranslate">Date.UTC();
Date.UTC(1);

// Safari: NaN
// Chrome/Opera/V8: NaN

// Firefox &lt;54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN
</pre>

<h2 id="Див._також">Див. також</h2>

<ul>
 <li>{{jsxref("Date.parse()")}}</li>
</ul>

<h2 id="Дізнатись_більше">Дізнатись більше</h2>

<ul>
 <li>{{Interwiki("wikipedia", "UTC", "Всесвітній координований час (UTC)")}} у Вікіпедії</li>
 <li>{{Interwiki("wikipedia", "Час_Unix", "Час Unix")}} у Вікіпедії</li>
</ul>