Skip to content

SHDate.getTimezoneOffset()

متد GetTimeZoneOffset() تفاوت ، در عرض چند دقیقه ، بین تاریخی را که در منطقه زمانی UTC ارزیابی شده و همان تاریخ ارزیابی شده در منطقه زمانی محلی را برمی گرداند. امتحان کنید


Syntax

getTimezoneOffset();

مقدار برگشتی

تفاوت ، در دقیقه ، بین تاریخ ، همانطور که در منطقه زمانی UTC ارزیابی شده است ، و همانطور که در منطقه زمانی محلی ارزیابی شده است.

توضیحات

date.gettimezoneoffset() تفاوت ، در دقیقه ، بین تاریخ ارزیابی شده در منطقه زمانی UTC ، و تاریخ را که در منطقه زمانی محلی ارزیابی شده است - یعنی منطقه زمانی سیستم میزبان که در آن مرورگر استفاده می شود ، برمی گرداند.اگر کد از وب در یک مرورگر اجرا شود) ، یا در غیر این صورت سیستم میزبان هر زمان اجرا JavaScript (به عنوان مثال ، یک محیط Node.js) کد در آن اجرا می شود.

مقادیر منفی و مقادیر مثبت اگر منطقه زمانی محلی در پشت UTC باشد ، تعداد دقایقی که توسط getTimeZoneOffset() مثبت است ، مثبت است و اگر منطقه زمانی محلی از UTC جلوتر باشد ، منفی است.به عنوان مثال ، برای UTC+10 ، -600 بازگردانده می شود.

منطقه زمانی فعلی UTC-8 UTC UTC+3 مقدار بازگشت 480 0 -180 نتایج متنوع در زمان صرفه جویی در نور روز (DST) مناطق زمانی در یک منطقه زمانی که سالانه در زمان صرفه جویی در نور روز (DST) تغییر می کند و خارج می شود ، تعداد دقایقی که با فراخوانی GetTimeZoneOffset() برگشت داده می شود ، می تواند متفاوت باشد.

یک منطقه زمانی محلی خاص و یک تاریخ تاریخ 1 را در نظر بگیرید که هم در DST است ، و دقایقی را در نظر بگیرید ، تعداد دقایقی که با فراخوانی تاریخ 1.gettimezoneoffset() بازگردانده می شود.سپس:

اگر منطقه زمانی محلی در حال حاضر در DST باشد ، اما تاریخ تاریخ مشخص 2 در DST نیست ، تعداد دقایقی که توسط Date2.GettimeZoneOffset() بازگردانده می شود 60 دقیقه است. اگر منطقه زمانی محلی در حال حاضر در DST نباشد ، اما تاریخ تاریخ مشخصی در DST است ، تعداد دقایقی که توسط Date3.gettimezoneOffset() دقیقه بازگردانده شده است 60 دقیقه است. در یک منطقه زمانی که سالانه از زمان صرفه جویی در نور روز (DST) تغییر نمی کند و خارج نمی شود ، تعداد دقایقی که با فراخوانی GetTimeZoneOffset() بازگردانده می شود ، بدون در نظر گرفتن نمونه ای که از آن خوانده می شود ، همان تعداد دقایقی را برمی گرداند.

توجه: توضیحات فوق ساده سازی است.در پیاده سازی ها ، از پایگاه داده منطقه زمانی IANA (TZDATA) برای تعیین دقیق تأثیر DST در محاسبه اختلاف منطقه زمانی استفاده می شود.

نمونه‌ها

// Create a Date instance for the current time
let currentLocalDate = new SHDate();
// Create a Date instance for 03:24 GMT-0200 on May 1st in 2016
let laborDay2016at0324GMTminus2 = new SHDate("Day 1, 1402 03:24:00 GMT-0200");
currentLocalDate.getTimezoneOffset() ===
	laborDay2016at0324GMTminus2.getTimezoneOffset();
// true, always, in any timezone that doesn't annually shift in and out of DST
// false, sometimes, in any timezone that annually shifts in and out of DST

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset