الفرق بين المراجعتين لصفحة: «Python/datetime/timezone»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.timezone()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الصنف <code>datetime.timezone()</code> في بايثون}}</noinclude> | ||
الصنف timezone هو صنف فرعي من الصنف | الصنف <code>timezone</code> هو صنف فرعي من الصنف <code>[[Python/datetime/tzinfo|tzinfo]]</code>، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق. | ||
يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية. | يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية. | ||
== البنية العامة == | |||
<syntaxhighlight lang="python3"> | |||
class datetime.timezone(offset, name=None) | |||
</syntaxhighlight> | |||
== المعاملات == | |||
=== <code>offset</code> === | |||
كائن <code>timedelta</code> يمثّل الفارق بين التوقيت المحلي والتوقيت العالمي المنسّق، ويجب أن يأخذ قيمة تكون ضمن النطاق <code>-timedelta(hours=24)</code> و <code>timedelta(hours=24)</code> وإلّا يطلق التابع الخطأ <code>ValueError</code>. | |||
=== <code>name</code> === | |||
معامل اختياري، وهو عبارة عن [[Python/str|سلسلة نصية]] تستخدم كقيمة يعيدها التابع <code>[[Python/datetime/datetime/tzname|datetime.tzname()]]</code>. | |||
'''ملاحظات:''' | |||
* هذا الصنف جديد في الإصدار 3.2 من بايثون. | |||
* لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة. | |||
== خصائص الصنف <code>timezone</code> == | |||
يقدّم الصنف <code>timezone</code> خاصّية واحدة فقط: | |||
=== <code>timezone.utc</code> === | |||
المنطقة الزمنية UTC، وتكافئ التعبير <code>timezone(timedelta(0))</code>. | |||
== توابع الصنف <code>timezone</code> == | == توابع الصنف <code>timezone</code> == | ||
| سطر 9: | سطر 33: | ||
يقدّم الصنف <code>timezone</code> التوابع التالية: | يقدّم الصنف <code>timezone</code> التوابع التالية: | ||
=== التابع <code>[[Python/datetime/timezone/utcoffset|timezone.utcoffset()]]</code> === | |||
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. | |||
=== التابع <code>timezone.tzname()</code> === | |||
=== التابع <code>timezone.dst()</code> === | |||
=== التابع <code>timezone.fromutc()</code> === | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/datetime.html#datetime.timezone قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/datetime.html#datetime.timezone قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
مراجعة 21:12، 10 يوليو 2018
الصنف timezone هو صنف فرعي من الصنف tzinfo، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق.
يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية.
البنية العامة
class datetime.timezone(offset, name=None)
المعاملات
offset
كائن timedelta يمثّل الفارق بين التوقيت المحلي والتوقيت العالمي المنسّق، ويجب أن يأخذ قيمة تكون ضمن النطاق -timedelta(hours=24) و timedelta(hours=24) وإلّا يطلق التابع الخطأ ValueError.
name
معامل اختياري، وهو عبارة عن سلسلة نصية تستخدم كقيمة يعيدها التابع datetime.tzname().
ملاحظات:
- هذا الصنف جديد في الإصدار 3.2 من بايثون.
- لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة.
خصائص الصنف timezone
يقدّم الصنف timezone خاصّية واحدة فقط:
timezone.utc
المنطقة الزمنية UTC، وتكافئ التعبير timezone(timedelta(0)).
توابع الصنف timezone
يقدّم الصنف timezone التوابع التالية:
التابع timezone.utcoffset()
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone.