الفرق بين المراجعتين ل"Python/datetime/date/timetuple"

من موسوعة حسوب
< Python‏ | datetime‏ | date
اذهب إلى التنقل اذهب إلى البحث
 
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
 +
<noinclude>{{DISPLAYTITLE:التابع <code>date.timetuple()‎</code> في بايثون}}</noinclude>
 
يعيد التابع الصنف <code>time.struct_time</code> كما تعيده الدالة <code>time.localtime()</code>‎. تكون الساعات والدقائق والثواني أصفارًا، وتأخذ الراية <code>DST</code> القيمة <code>‎-1</code>.
 
يعيد التابع الصنف <code>time.struct_time</code> كما تعيده الدالة <code>time.localtime()</code>‎. تكون الساعات والدقائق والثواني أصفارًا، وتأخذ الراية <code>DST</code> القيمة <code>‎-1</code>.
  
سطر 11: سطر 12:
 
== القيمة المعادة ==
 
== القيمة المعادة ==
  
−
يعيد التابع الصنف <code>time.struct_time</code>.
+
يعيد التابع الصنف <code>time.struct_time</code>. وهو عبارة عن كائن يتضمّن [[Python/tuples#.D8.A7.D9.84.D8.B5.D9.81.D9.88.D9.81 .D8.A7.D9.84.D9.85.D8.B3.D9.85.D9.91.D8.A7.D8.A9 .28named tuples.29|صفًّا مسمّىً named tuple]]. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما هو موضح في الجدول التالي:
 +
{| class="wikitable"
 +
!الفهرس
 +
!اسم الخاصية
 +
!الوصف
 +
|-
 +
|<code>0</code>
 +
|<code>tm_year</code>
 +
|السنة
 +
|-
 +
|<code>1</code>
 +
|<code>tm_mon</code>
 +
|الشهر
 +
|-
 +
|<code>2</code>
 +
|<code>tm_mday</code>
 +
|اليوم
 +
|-
 +
|<code>3</code>
 +
|<code>tm_hour</code>
 +
|الساعة
 +
|-
 +
|<code>4</code>
 +
|<code>tm_min</code>
 +
|الدقيقة
 +
|-
 +
|<code>5</code>
 +
|<code>tm_sec</code>
 +
|الثانية
 +
|-
 +
|<code>6</code>
 +
|<code>tm_wday</code>
 +
|عدد اليوم في الأسبوع
 +
|-
 +
|<code>7</code>
 +
|<code>tm_yday</code>
 +
|عدد اليوم في السنة
 +
|-
 +
|<code>8</code>
 +
|<code>tm_isdst</code>
 +
|التوقيت الصيفي
 +
|}
  
 
== أمثلة ==
 
== أمثلة ==
سطر 33: سطر 75:
 
177      # اليوم 177 في السنة
 
177      # اليوم 177 في السنة
 
-1        # DST الراية
 
-1        # DST الراية
 +
>>> t.tm_year
 +
2018
 +
>>> t.tm_yday
 +
177
 +
>>> t[2]
 +
26
 +
>>> t[8]
 +
-1
 
</syntaxhighlight>
 
</syntaxhighlight>
  

المراجعة الحالية بتاريخ 17:59، 26 يونيو 2018

يعيد التابع الصنف 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

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Python/datetime/date/timetuple&oldid=11344"