Date.UTC()

This translation is incomplete. Please help translate this article from English

دالة 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 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Living Standard  
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 AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
UTCChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 3Opera Full support 3Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

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

اقرأ أيضاً