التابع timezone.utcoffset()
في بايثون
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone
.
البنية العامة
timezone.utcoffset(dt)
القيمة المعادة
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone
، ويجري تجاهل المعامل dt
.
تكون القيمة المعادة عبارة عن نسخة من الصنف timedelta
مساوية لفارق التوقيت بين التوقيت المحلي والتوقيت العالمي المنسّق.
ملاحظة: لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> from datetime import datetime, timedelta, timezone
>>> AST = timezone(timedelta(hours=3), name="Arabia Standard Time")
>>> dt = datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST)
>>> print(dt)
2018-07-11 00:21:12+03:00
>>> dt.tzname()
'Arabia Standard Time'
>>> AST.utcoffset(dt)
datetime.timedelta(0, 10800)
>>> print(AST.utcoffset(dt))
3:00:00
انظر أيضًا
- التابع
timezone.tzname()
: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنفtimezone
.