الفرق بين المراجعتين ل"Python/datetime/tzinfo/utcoffset"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> يعيد التابع كائن timedelta يمثّل مقدار إ...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | ||
| − | يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. | + | يعيد التابع كائن <code>[[Python/datetime/timedelta|timedelta]]</code> يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. |
== البنية العامة == | == البنية العامة == | ||
| سطر 12: | سطر 12: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| − | يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. | + | يعيد التابع كائن <code>[[Python/datetime/timedelta|timedelta]]</code> يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. |
| + | |||
إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة. | إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة. | ||
| − | يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن tzinfo يمثّل كلًّا من المنطقة الزمنية والتوقيت الصيفي، فيجب حينئذٍ أن يعيد التابع utcoffset() مجموع هذين المقدارين. | + | يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن <code>tzinfo</code> يمثّل كلًّا من المنطقة الزمنية والتوقيت الصيفي، فيجب حينئذٍ أن يعيد التابع <code>utcoffset()</code> مجموع هذين المقدارين. |
| − | إن كان مقدار الإزاحة عن التوقيت العالمي المنسّق غير معروف، فإنّ التابع يعيد القيمة | + | إن كان مقدار الإزاحة عن التوقيت العالمي المنسّق غير معروف، فإنّ التابع يعيد القيمة <code>None</code>، وإلّا فإنّه يجب أن تكون القيمة المعادة لكائن <code>[[Python/datetime/timedelta|timedelta]]</code> ضمن النطاق |
| − | -timedelta(hours=24) | + | <code>-timedelta(hours=24)</code> و <code>timedelta(hours=24)</code> أي يجب أن لا يزيد مقدار الإزاحة عن يوم واحد. |
| − | + | عادة ما يُستخدم التابع <code>utcoffset()</code> بإحدى الطريقتين التاليتين:<syntaxhighlight lang="python3"> | |
| − | + | return CONSTANT # صنف ذو إزاحة ثابتة | |
| − | عادة ما يُستخدم التابع utcoffset() بإحدى الطريقتين التاليتين: | + | return CONSTANT + self.dst(dt) # صنف يأخذ التوقيت الصيفي بنظر الاعتبار |
| + | </syntaxhighlight> | ||
| − | + | إن لم يعد التابع <code>utcoffoset()</code> القيمة <code>None</code>، فيجب أن لا يعيد التابع <code>dst()</code> هذه القيمة أيضًا. | |
| − | |||
| − | + | تطلق طريقة الاستخدام الافتراضية للتابع <code>utcoffset()</code> الخطأ <code>NotImplementedError</code>. | |
| − | تطلق طريقة الاستخدام الافتراضية للتابع utcoffset() الخطأ NotImplementedError. | ||
| − | '''ملاحظة''': لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقصورًا على الأعداد الصحيحة للدقائق. | + | '''ملاحظة''': لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقصورًا على الأعداد الصحيحة للدقائق في الإصدار 3.7 من اللغة. |
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 21:55، 9 يوليو 2018
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC.
البنية العامة
tzinfo.utcoffset(dt)
المعاملات
القيمة المعادة
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC.
إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة.
يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن tzinfo يمثّل كلًّا من المنطقة الزمنية والتوقيت الصيفي، فيجب حينئذٍ أن يعيد التابع utcoffset() مجموع هذين المقدارين.
إن كان مقدار الإزاحة عن التوقيت العالمي المنسّق غير معروف، فإنّ التابع يعيد القيمة None، وإلّا فإنّه يجب أن تكون القيمة المعادة لكائن timedelta ضمن النطاق
-timedelta(hours=24) و timedelta(hours=24) أي يجب أن لا يزيد مقدار الإزاحة عن يوم واحد.
عادة ما يُستخدم التابع utcoffset() بإحدى الطريقتين التاليتين:
return CONSTANT # صنف ذو إزاحة ثابتة
return CONSTANT + self.dst(dt) # صنف يأخذ التوقيت الصيفي بنظر الاعتبار
إن لم يعد التابع utcoffoset() القيمة None، فيجب أن لا يعيد التابع dst() هذه القيمة أيضًا.
تطلق طريقة الاستخدام الافتراضية للتابع utcoffset() الخطأ NotImplementedError.
ملاحظة: لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقصورًا على الأعداد الصحيحة للدقائق في الإصدار 3.7 من اللغة.
أمثلة
يبين المثال التالي آلية عمل التابع:
انظر أيضًا
مصادر
قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.