الفرق بين المراجعتين ل"Python/datetime/datetime/utctimetuple"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.datetime.utctimetuple()</code> في بايثون}}</noinclude> يعيد التابع الصنف time.struct_tim...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.datetime.utctimetuple()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.datetime.utctimetuple()</code> في بايثون}}</noinclude> | ||
| − | يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime() ولكن حسب التوقيت العالمي المنسّق. | + | يعيد التابع الصنف <code>time.struct_time</code> كما تعيده الدالة <code>time.localtime()</code> ولكن حسب التوقيت العالمي المنسّق. |
== البنية العامة == | == البنية العامة == | ||
| سطر 10: | سطر 10: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| − | إن كان كائن datetime (نفرض أنّه dt) كائنًا بسيطًا، فإنّ القيمة المعادة من هذا التابعة مشابهة للقيمة المعادة من التابع dt.timetuple() باستثناء | + | إن كان كائن <code>datetime</code> (نفرض أنّه <code>dt</code>) كائنًا بسيطًا، فإنّ القيمة المعادة من هذا التابعة مشابهة للقيمة المعادة من التابع <code>dt.timetuple()</code> باستثناء أنّ قيمة الراية <code>tm_isdst</code> تكون <code>0</code> بصرف النظر عمّا يعيده التابع <code>[[Python/datetime/datetime/dst|dt.dst()]]</code>. بمعنى أنّ التوقيت الصيفي لن يتأثر بالتوقيت العالمي المنسّق. |
| − | أما إذا كان الكائن dt واعيًا، فإنّه يعاير إلى التوقيت العالمي المنسّق وذلك بطرح المقدار dt.utcoffset() منه، ويعيد التابع بعدها الصنف time.struct_time الخاص بالوقت الذي جرت معايرته مسبقًا، وتُفرض القيمة 0 على الراية tm_isdst. | + | أما إذا كان الكائن dt واعيًا، فإنّه يعاير إلى التوقيت العالمي المنسّق وذلك بطرح المقدار <code>[[Python/datetime/datetime/utcoffset|dt.utcoffset()]]</code> منه، ويعيد التابع بعدها الصنف <code>time.struct_time</code> الخاص بالوقت الذي جرت معايرته مسبقًا، وتُفرض القيمة <code>0</code> على الراية <code>tm_isdst</code>. |
| − | جدير بالذكر أنّه قد تطلق اللغة الخطأ OverflowError إن كانت قيمة dt.year مساوية لقيمة MINYEAR أو | + | جدير بالذكر أنّه قد تطلق اللغة الخطأ <code>OverflowError</code> إن كانت قيمة <code>dt.year</code> مساوية لقيمة <code>MINYEAR</code> أو <code>MAXYEAR</code>، وإن أدّت عملية المعايرة إلى تجاوز هذين الحدين. |
== أمثلة == | == أمثلة == | ||
| سطر 41: | سطر 41: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * التابع datetime.datetime.timetuple(): يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime(). | + | * التابع <code>[[Python/datetime/datetime/timetuple|datetime.datetime.timetuple()]]</code>: يعيد التابع الصنف <code>time.struct_time</code> كما تعيده الدالة <code>time.localtime()</code>. |
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 23:54، 7 يوليو 2018
يعيد التابع الصنف 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 في توثيق بايثون الرسمي.