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

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎ ولكن حسب التوقيت العالمي المنسّق.

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

‎datetime.utctimetuple()

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

إن كان كائن datetime (نفرض أنّه dt) كائنًا بسيطًا، فإنّ القيمة المعادة من هذا التابعة مشابهة للقيمة المعادة من التابع dt.timetuple()‎ باستثناء أنّ قيمة الراية tm_isdst تكون 0 بصرف النظر عمّا يعيده التابع dt.dst()‎. بمعنى أنّ التوقيت الصيفي لن يتأثر بالتوقيت العالمي المنسّق.

أما إذا كان الكائن dt واعيًا، فإنّه يعاير إلى التوقيت العالمي المنسّق وذلك بطرح المقدار dt.utcoffset()‎ منه، ويعيد التابع بعدها الصنف time.struct_time الخاص بالوقت الذي جرت معايرته مسبقًا، وتُفرض القيمة 0 على الراية tm_isdst.

جدير بالذكر أنّه قد تطلق اللغة الخطأ OverflowError إن كانت قيمة dt.year مساوية لقيمة MINYEAR أو MAXYEAR، وإن أدّت عملية المعايرة إلى تجاوز هذين الحدين.

أمثلة

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

>>> from datetime import datetime
>>> dt = datetime(2018, 8, 7, 2, 48, 4)
>>> dt.utctimetuple()
time.struct_time(tm_year=2018, tm_mon=8, tm_mday=7, tm_hour=2, tm_min=48, tm_sec=4, tm_wday=1, tm_yday=219, tm_isdst=0)
>>> t = dt.utctimetuple()
>>> for i in t:
...     print(i)
... 
2018
8
7
2
48
4
1
219
0

انظر أيضًا

• التابع datetime.datetime.timetuple()‎: يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎.

مصادر

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