التابع 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 Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.