التابع datetime.time() في بايثون
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC.
البنية العامة
tzinfo.utcoffset(dt)
المعاملات
القيمة المعادة
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة.
يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن tzinfo يمثّل كلًّا من المنطقة الزمنية والتوقيت الصيفي، فيجب حينئذٍ أن يعيد التابع utcoffset() مجموع هذين المقدارين.
إن كان مقدار الإزاحة عن التوقيت العالمي المنسّق غير معروف، فإنّ التابع يعيد القيمة None، وإلّا فإنّه يجب أن تكون القيمة المعادة كائن timedelta ضمن النطاق
-timedelta(hours=24) and timedelta(hours=24)
يجب أن لا يزيد مقدار الإزاحة عن يوم واحد.
عادة ما يُستخدم التابع utcoffset() بإحدى الطريقتين التاليتين:
return CONSTANT # fixed-offset class return CONSTANT + self.dst(dt) # daylight-aware class
إن لم يعد التابع utcoffoset() القيمة None، فيجب أن لا يعيد التابع dst() هذه القيمة أيضًا. تطلق طريقة الاستخدام الافتراضية للتابع utcoffset() الخطأ NotImplementedError.
ملاحظة: لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقصورًا على الأعداد الصحيحة للدقائق.
أمثلة
يبين المثال التالي آلية عمل التابع:
انظر أيضًا
مصادر
قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.