هذه الترجمة لم تكتمل. رجاءً ساعد بترجمة هذه المقالة من الإنجليزية.

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

بنية الجملة

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

المعاملات (Parameters)

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

القيمة العائدة

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

الوصف

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

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

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

  • تستخدم دالة Date.UTC() التوقيت العالمي بدلاً من التوقيت المحلي.
  • تقوم دالة Date.UTC() بإرجاع قمية الوقت إلي رقم بدلاً من إنشاء تاريخ.

If a parameter you specify is outside of the expected range, the UTC() 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 (year + 1), and 3 will be used for the month.

Because UTC() is a static method of Date, you always use it as Date.UTC(), rather than as a method of a Date object you created.

أمثلة

استخدام Date.UTC()

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

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

الخصائص

Specification Status Comment
ECMAScript Latest Draft (ECMA-262)
The definition of 'Date.UTC' in that specification.
Draft  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.0.

دعم المتصفحات

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support YesEdge Full support YesFirefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

ملاحظات التوافق

Date.UTC with fewer than two arguments

When providing less than two arguments to Date.UTC, NaN is returned. This behavior is specified in ECMAScript 2017. Engines who weren't supporting this behavior, have been updated (see bug 1050755, ecma-262 #642).

Date.UTC();
Date.UTC(1);

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

// Firefox <54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN

اقرأ أيضاً

Document Tags and Contributors

المساهمون في هذه الصفحة: GawiSh404
آخر مَن حدّثها: GawiSh404,