روش JavaScript Date UTC()

تعریف و استفاده

UTC() این روش مقدار میلiseconds بین تاریخ مشخص شده و نیمه شب 1 ژانویه 1970 را بر اساس زمان جهانی بازمی‌گرداند.

توضیحات:زمان هماهنگ جهانی (UTC) زمانی است که توسط استاندارد زمان جهانی تعیین شده است.

نکته:زمان UTC با زمان GMT (زمان گرینویچ) مشابه است.

مثال

مثال 1

مقدار میلiseconds بین تاریخ مشخص شده و نیمه شب 1 ژانویه 1970 را بازگرداند:

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

آزمایش کنید

مثال 2

برای ایجاد یک شیء تاریخ از زمان UTC به جای زمان محلی استفاده کنید:

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. نشان‌دهنده عدد صحیح میلiseconds است

مقدار پیش‌فرض بین 0-999 است، اما سایر مقادیر نیز مجاز هستند:

  • -1 باعث می‌شود که آخرین میلiseconds از ثانیه قبل باشد
  • 1000 باعث می‌شود که اولین میلiseconds از ثانیه بعدی باشد

جزئیات فنی

مقدار بازگشتی: عدد، که میزان میلiseconds بین تاریخ و زمان مشخص شده و نیمه شب 1 ژانویه 1970 را نشان می‌دهد.
JavaScript نسخه: ECMAScript 1

پشتیبانی مرورگر

روش Chrome IE Firefox Safari Opera
UTC() پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

آموزش:تاریخ JavaScript

آموزش:قالب‌بندی تاریخ JavaScript