التابع 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 في توثيق بايثون الرسمي.