التابع date.timetuple()‎ في بايثون

من موسوعة حسوب
< Python‏ | datetime‏ | date
اذهب إلى التنقل اذهب إلى البحث

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎. تكون الساعات والدقائق والثواني أصفارًا، وتأخذ الراية DST القيمة ‎-1.

هذا التابع مكافئ للصنف ‎time.struct_time((d.year, d.month,d.day, 0, 0, 0, d.weekday(), yday, -1))‎ حيث ‎yday = d.toordinal() - date(d.year,1, 1).toordinal() + 1‎ وهو عدد اليوم في السنة الحالية بدءًا من اليوم الأول فيها.

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

date.timetuple()

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

يعيد التابع الصنف time.struct_time. وهو عبارة عن كائن يتضمّن صفًّا مسمّىً named tuple. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما هو موضح في الجدول التالي:

الفهرس اسم الخاصية الوصف
0 tm_year السنة
1 tm_mon الشهر
2 tm_mday اليوم
3 tm_hour الساعة
4 tm_min الدقيقة
5 tm_sec الثانية
6 tm_wday عدد اليوم في الأسبوع
7 tm_yday عدد اليوم في السنة
8 tm_isdst التوقيت الصيفي

أمثلة

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

>>> from datetime import date
>>> d = date(2018, 6, 26)
>>> t = d.timetuple()
>>> for i in t:
...     print(i)
... 
2018      # السنة
6         # الشهر
26        # اليوم
0         # الساعة
0         # الدقيقة
0         # الثانية
1         # اسم اليوم (0 = الاثنين)‏
177       # اليوم 177 في السنة
-1        # DST الراية
>>> t.tm_year
2018
>>> t.tm_yday
177
>>> t[2]
26
>>> t[8]
-1

مصادر