طريقة JavaScript Date UTC()

التعريف والاستخدام

UTC() يُرجع هذا الدالة الوقت العالمي (UTC) إلى عدد الأجزاء من المليون ثانية بين التاريخ المحدد و منتصف الليل من 1 يناير 1970.

نصيحة:الوقت العالمي (UTC) هو الوقت الذي يحدده معيار الوقت العالمي.

التعليق:الوقت العالمي (UTC) والوقت العالمي (GMT) نفسه.

مثال

مثال 1

يعود إلى عدد الأجزاء من المليون ثانية بين التاريخ المحدد و منتصف الليل من 1 يناير 1970:

var d = Date.UTC(2012, 02, 30);

جرب بنفسك

مثال 2

إنشاء كائن تاريخ باستخدام الوقت العالمي بدلاً من الوقت المحلي:

var d = new Date(Date.UTC(2012, 02, 30));

جرب بنفسك

النحو

Date.UTC(year, month, day, hours, minutes, seconds, millisec)

قيمة الم参数

الم参数 الوصف
year مطلوب. يمثل الرقم الأربعة للسنة، ويُسمح بالقيم السلبية
month

مطلوب. يمثل عدد الشهر كامل

القيمة المتوقعة تكون بين 0-11، ولكن يُسمح بأرقام أخرى:

  • -1 سيؤدي إلى الشهر الأخير في السنة السابقة
  • 12 سيؤدي إلى الشهر الأول في السنة التالية
  • 13 سيؤدي إلى الشهر الثاني في السنة التالية
day

اختياري. عدد صحيح، يمثل اليوم في الشهر

القيمة المتوقعة تكون بين 1-31، ولكن يُسمح بأرقام أخرى:

  • 0 سيؤدي إلى آخر ساعة في الشهر السابق
  • -1 سيؤدي إلى الساعة السابقة قبل آخر ساعة في الشهر السابق

إذا كان الشهر يحتوي على 31 يومًا:

  • 32 سيؤدي إلى اليوم الأول في الشهر التالي

إذا كان الشهر يحتوي على 30 يومًا:

  • 32 سيؤدي إلى اليوم الثاني في الشهر التالي
hour

اختياري. القيمة الافتراضية هي 0. يمثل عدد الساعات كامل

القيمة المتوقعة تكون بين 0-23، ولكن يُسمح بأرقام أخرى:

  • -1 سيؤدي إلى آخر ساعة في اليوم السابق
  • 24 سيؤدي إلى الساعة الأولى في اليوم التالي
min

اختياري. القيمة الافتراضية هي 0. يمثل عدد الدقائق كامل

القيمة المتوقعة تكون بين 0-59، ولكن يُسمح بأرقام أخرى:

  • -1 سيؤدي إلى آخر دقيقة في الساعة السابقة
  • 60 سيؤدي إلى أول دقيقة في الساعة التالية
sec

اختياري. القيمة الافتراضية هي 0. يمثل عدد الثواني كامل

القيمة المتوقعة تكون بين 0-59، ولكن يُسمح بأرقام أخرى:

  • -1 سيؤدي إلى آخر ثانية في الدقيقة السابقة
  • 60 سيؤدي إلى أول ثانية في الدقيقة التالية
millisec

اختياري. القيمة الافتراضية هي 0. يمثل عدد الملي ثانية كامل

القيمة المتوقعة تكون بين 0-999، ولكن يُسمح بأرقام أخرى:

  • -1 سيؤدي إلى آخر ملي ثانية في الثانية السابقة
  • 1000 سيؤدي إلى أول ملي ثانية في الثانية التالية

تفاصيل تقنية

النتيجة المقدمة: رقم، يمثل عدد الأجزاء من المليون ثانية بين التاريخ والوقت المحدد و منتصف الليل من 1 يناير 1970.
JavaScript إصدار: ECMAScript 1

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

الطريقة Chrome IE Firefox Safari Opera
UTC() الدعم الدعم الدعم الدعم الدعم

الصفحات ذات الصلة

دروس:تاريخ JavaScript

دروس:تنسيق تاريخ JavaScript