---
title: Date.UTC()
slug: Web/JavaScript/Reference/Global_Objects/Date/UTC
tags:
  - تاريخ
  - جافاسكربت
  - طريقة
  - مرجع
translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC
---
<div>{{JSRef}}</div>

<p>دالة <strong><code>Date.UTC()</code></strong> تقبل نفس المُعاملات parameters علي الرغم من طول تكوين المنشيء، ويٌعيد التاريخ إلي المللي ثانية من بداية تاريخ 1 يناير, 1970, 00:00:00, التوقيت العالمي.</p>

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



<h2 id="بنية_الجملة">بنية الجملة</h2>

<pre class="syntaxbox">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="المعاملات_(Parameters)">المعاملات (Parameters)</h3>

<dl>
 <dt><code>year</code></dt>
 <dd>سنة كاملة.</dd>
 <dt><code>month</code></dt>
 <dd>رقم صحيح ما بين 0 و11 يمثل الشهر.</dd>
 <dt><code>day</code></dt>
 <dd>اختياري. رقم صحيح ما بين 1 و31 يمثل يوم من الشهر.</dd>
 <dt><code>hour</code></dt>
 <dd>اختياري. رقم صحيح ما بين 0 و23 يمثل الساعات.</dd>
 <dt><code>minute</code></dt>
 <dd>اختياري. رقم صحيح ما بين 0 و59 يمثل الدقائق.</dd>
 <dt><code>second</code></dt>
 <dd>اختياري. رقم صحيح ما بين 0 و59 يمثل الثواني.</dd>
 <dt><code>millisecond</code></dt>
 <dd>اختياري. رقم صحيح ما بين 0 و999 يمثل الميلي ثانية.</dd>
</dl>

<h3 id="القيمة_العائدة">القيمة العائدة</h3>

<p>رقم يمثل عدد المللي ثانية في التاريخ المحدد منذ 1 يناير, 1970, 00:00:00، التوقيت العالمي.</p>

<h2 id="الوصف">الوصف</h2>

<p>تقوم دالة <code>UTC()</code> بأخذ معاملات (parameters) التاريخ المحددة بفاصلة ثم تُعيدها إلي مللي ثانية بين 1 يناير 1970، 00:00:00 التوقيت العالمي، والوقت الذي حددته.</p>

<p>يجب عليك تحديد <code>السنة</code> كاملة؛ علي سبيل المثال, 1998. إذا كانت السنة محددة ما بين عام 0 و99، تقوم هذه الطريقة بتحويل السنه إلي سنه في القرن العشرين <code>(1900 + سنة)</code>؛ علي سبيل المثال، إذا حددت 95، فسيتم أستخدام 1995.</p>

<p>تختلف طريقة <code>UTC()</code> عن منشيء التاريخ بطريقتين.</p>

<ul>
 <li>تستخدم دالة <code>Date.UTC()</code> التوقيت العالمي بدلاً من التوقيت المحلي.</li>
 <li>تقوم دالة <code>Date.UTC()</code> بإرجاع قمية الوقت إلي رقم بدلاً من إنشاء تاريخ.</li>
</ul>

<p>If a parameter you specify is outside of the expected range, the <code>UTC()</code> method updates the other parameters to allow for your number. For example, if you use 15 for month, the year will be incremented by 1 <code>(year + 1)</code>, and 3 will be used for the month.</p>

<p>Because <code>UTC()</code> is a static method of {{jsxref("Date")}}, you always use it as <code>Date.UTC()</code>, rather than as a method of a {{jsxref("Date")}} object you created.</p>

<h2 id="أمثلة">أمثلة</h2>

<h3 id="استخدام_Date.UTC()">استخدام <code>Date.UTC()</code></h3>

<p>في المثال التالي يقوم بإنشاء التاريخ بإستخدام UTC بدلاً من التوقيت المحلي:</p>

<pre class="brush:js">var utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));
</pre>

<h2 id="الخصائص">الخصائص</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</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>Initial definition. Implemented in JavaScript 1.0.</td>
  </tr>
 </tbody>
</table>

<h2 id="دعم_المتصفحات">دعم المتصفحات</h2>

<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>

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

<h2 id="ملاحظات_التوافق">ملاحظات التوافق</h2>

<h3 id="Date.UTC_with_fewer_than_two_arguments"><code>Date.UTC</code> with fewer than two arguments</h3>

<p>When providing less than two arguments to <code>Date.UTC</code>, {{jsxref("NaN")}} is returned. This behavior is specified in ECMAScript 2017. Engines who weren't supporting this behavior, have been updated (see {{bug(1050755)}}, <a href="https://github.com/tc39/ecma262/pull/642">ecma-262 #642</a>).</p>

<pre class="brush: js">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>