التابع datetime.datetime.utcoffset()‎ في بايثون

يحدّد التابع مقدار إزاحة الوقت في كائن datetime عن التوقيت العالمي المنسّق.

البنية العامة

‎datetime.utcoffset()

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

إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.utcoffset(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد.

ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق.

أمثلة

يبين المثال التالي آلية عمل التابع:

‎>>> from datetime import datetime, tzinfo, timedelta
>>> class GMT1(tzinfo):
...     def utcoffset(self, dt):
...             return timedelta(hours=1)
... 
>>> dt = datetime(2018, 7, 8, 1, 26, 43, tzinfo=GMT1())
>>> gmt = GMT1()
>>> dt.utcoffset()
datetime.timedelta(0, 3600)
>>> print(dt.utcoffset())
1:00:00

انظر أيضًا

• التابع datetime.dst()‎: التحكم في نظام التوقيت الصيفي.
• التابع datetime.tzname()‎: يحدّد التابع اسم المنطقة الزمنية.

مصادر

قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.