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

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

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

‎tzinfo.utcoffset(dt)

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

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

إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة.

يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن tzinfo يمثّل كلًّا من المنطقة الزمنية والتوقيت الصيفي، فيجب حينئذٍ أن يعيد التابع utcoffset()‎ مجموع هذين المقدارين.

إن كان مقدار الإزاحة عن التوقيت العالمي المنسّق غير معروف، فإنّ التابع يعيد القيمة None، وإلّا فإنّه يجب أن تكون القيمة المعادة لكائن timedelta ضمن النطاق

‎-timedelta(hours=24)‎ و timedelta(hours=24)‎ أي يجب أن لا يزيد مقدار الإزاحة عن يوم واحد.

عادة ما يُستخدم التابع utcoffset()‎ بإحدى الطريقتين التاليتين:

return CONSTANT                 # صنف ذو إزاحة ثابتة
return CONSTANT + self.dst(dt)  # صنف يأخذ التوقيت الصيفي بنظر الاعتبار

إن لم يعد التابع utcoffoset()‎ القيمة None، فيجب أن لا يعيد التابع dst()‎ هذه القيمة أيضًا.

تطلق طريقة الاستخدام الافتراضية للتابع utcoffset()‎ الخطأ NotImplementedError.

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

أمثلة

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

مصادر

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