التابع 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. - التابع
timezone.fromutc(): يعيد التابع قيمة كائنdatetimeمضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.