الفرق بين المراجعتين لصفحة: «Python/datetime/timezone»
لا ملخص تعديل |
|||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 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>[[Python/datetime/timezone/tzname|timezone.tzname()]]</code> === | |||
يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | |||
=== التابع <code>timezone.dst()</code> === | |||
يعيد القيمة <code>None</code> دائمًا. | |||
=== التابع <code>[[Python/datetime/timezone/fromutc|timezone.fromutc()]]</code> === | |||
يعيد التابع قيمة كائن <code>datetime</code> مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق. | |||
== انظر أيضًا == | |||
* الصنف <code>[[Python/datetime/date|datetime.date]]</code> في بايثون. | |||
* الصنف <nowiki/>[[Python/datetime/time|<code>datetime.time</code>]] في بايثون. | |||
* الصنف <code>[[Python/datetime/datetime|datetime.datetime]]</code> في بايثون. | |||
* الصنف <code>[[Python/datetime/tzinfo|datetime.tzinfo]]</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:57، 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.
التابع timezone.tzname()
يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف timezone.
التابع timezone.dst()
يعيد القيمة None دائمًا.
التابع timezone.fromutc()
يعيد التابع قيمة كائن datetime مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.
انظر أيضًا
- الصنف
datetime.dateفي بايثون. - الصنف
datetime.timeفي بايثون. - الصنف
datetime.datetimeفي بايثون. - الصنف
datetime.tzinfoفي بايثون.