الصنف datetime.timezone() في بايثون
الصنف timezone هو صنف فرعي من الصنف tzinfo، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق.
يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية.
البنية العامة
class datetime.timezone(offset, name=None)
المعاملات
offset
كائن timedelta يمثّل الفارق بين التوقيت المحلي والتوقيت العالمي المنسّق، ويجب أن يأخذ قيمة تكون ضمن النطاق -timedelta(hours=24) و timedelta(hours=24) وإلّا يطلق التابع الخطأ ValueError.
name
معامل اختياري، وهو عبارة عن سلسلة نصية تستخدم كقيمة يعيدها التابع datetime.tzname().
ملاحظات:
- هذا الصنف جديد في الإصدار 3.2 من بايثون.
- لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة.
خصائص الصنف timezone
يقدّم الصنف timezone خاصّية واحدة فقط:
timezone.utc
المنطقة الزمنية UTC، وتكافئ التعبير timezone(timedelta(0)).
توابع الصنف timezone
يقدّم الصنف timezone التوابع التالية:
التابع timezone.utcoffset()
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone.
التابع timezone.tzname()
يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف timezone.
التابع timezone.dst()
يعيد القيمة None دائمًا.
التابع timezone.fromutc()
يعيد التابع قيمة كائن datetime مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.
انظر أيضًا
- الصنف
datetime.dateفي بايثون. - الصنف
datetime.timeفي بايثون. - الصنف
datetime.datetimeفي بايثون. - الصنف
datetime.tzinfoفي بايثون.