التابع date.timetuple() في بايثون
يعيد التابع الصنف 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