الفرق بين المراجعتين ل"Python/datetime/tzinfo"
(أنشأ الصفحة ب'هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة،...') |
|||
| سطر 1: | سطر 1: | ||
| − | هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة، بل يجب اشتقاق صنف فرعي منه يتضمّن (على الأقل) توابع <code>tzinfo</code> القياسية التي ستُستخدم من طرف توابع الصنف <code>datetime</code>. | + | هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة، بل يجب اشتقاق صنف فرعي منه يتضمّن (على الأقل) توابع <code>tzinfo</code> القياسية التي ستُستخدم من طرف توابع الصنف <code>[[Python/datetime/datetime|datetime]]</code>. |
| − | تقدّم [[Python/datetime|وحدة <code>datetime</code>]] الصنف <code>[[Python/datetime/timezone|timezone]]</code> وهو صنف فرعي محدّد concrete بسيط من الصنف | + | تقدّم [[Python/datetime|وحدة <code>datetime</code>]] الصنف <code>[[Python/datetime/timezone|timezone]]</code> وهو [[Python/inhertance|صنف فرعي]] محدّد concrete بسيط من الصنف <code>tzinfo</code>، يمكن عن طريقه تمثيل المناطق الزمنية باستخدام مقدار إزاحة ثابت عن التوقيت العالمي المنسّق، مثل التوقيت العالمي المنسّق نفسه، أو توقيتي EST و EDT في أمريكا الشمالية. |
| − | يمكن تمرير نسخة الصنف tzinfo (صنف فرعي محدّد منه) إلى الدوال البانية لكائنات datetime و time. تكون خصائص هذه الكائنات حسب التوقيت المحلّي، ويقدّم كائن tzinfo التوابع التي تحدّد مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق، واسم المنطقة الزمنية، ومقدار إزاحة التوقيت الصيفي DST في كائن التاريخ أو الوقت الممرّر إليها. | + | يمكن تمرير نسخة الصنف <code>tzinfo</code> (صنف فرعي محدّد منه) إلى الدوال البانية لكائنات <code>[[Python/datetime/datetime/isoformat|datetime]]</code> و [[Python/datetime/datetime/isoformat|time]]. تكون خصائص هذه الكائنات حسب التوقيت المحلّي، ويقدّم كائن <code>tzinfo</code> التوابع التي تحدّد مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق، واسم المنطقة الزمنية، ومقدار إزاحة التوقيت الصيفي DST في كائن التاريخ أو الوقت الممرّر إليها. |
| − | تتطلب عملية pickling وجود التابع __init__() في الصنف الفرعي للصنف | + | تتطلب عملية pickling وجود التابع <code>__init__()</code> في الصنف الفرعي للصنف <code>tzinfo</code>، ويجب أن يكون التابع قابلًا للاستدعاء دون وجود معاملات، وإلا فقد تجرى عملية pickling هذا المطلب تقني بحت وقد يكون بالإمكان التساهل فيه مستقبلًا. |
| − | قد يحتاج الصنف الفرعي المحدّد من tzinfo إلى استخدام التوابع التالية، ويعتمد استخدام التوابع على طريقة استخدام كائنات datetime الواعية، وفي حال عدم إمكانية تحديد التابع المطلوب، يمكن استخدام التوابع جميعها. | + | قد يحتاج الصنف الفرعي المحدّد من <code>tzinfo</code> إلى استخدام التوابع التالية، ويعتمد استخدام التوابع على طريقة استخدام كائنات <code>[[Python/datetime/datetime|datetime]]</code> الواعية، وفي حال عدم إمكانية تحديد التابع المطلوب، يمكن استخدام التوابع جميعها. |
==توابع الصنف <code>tzinfo</code>== | ==توابع الصنف <code>tzinfo</code>== | ||
| − | ===التابع <code>tzinfo.utcoffset()</code>=== | + | ===التابع <code>[[Python/datetime/tzinfo/utcoffset|tzinfo.utcoffset()]]</code>=== |
| − | يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. | + | يعيد التابع كائن <code>[[Python/datetime/timedelta|timedelta]]</code> يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. |
| − | ===التابع <code>tzinfo.dst()</code>=== | + | ===التابع <code>[[Python/datetime/tzinfo/dst|tzinfo.dst()]]</code>=== |
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST). | يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST). | ||
| − | ===التابع <code>tzinfo.tzname()</code>=== | + | ===التابع <code>[[Python/datetime/tzinfo/tzname|tzinfo.tzname()]]</code>=== |
| − | يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية. | + | يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن <code>[[Python/datetime/datetime|datetime]]</code> على هيئة سلسلة نصية. |
| − | ===التابع <code>tzinfo.fromutc()</code>=== | + | ===التابع <code>[[Python/datetime/tzinfo/fromutc|tzinfo.fromutc()]]</code>=== |
| − | يستدعى هذا التابع عند استخدام التابع datetime.astimezone() بالطريقة الافتراضية. | + | يستدعى هذا التابع عند استخدام التابع <code>[[Python/datetime/datetime/astimezone|datetime.astimezone()]]</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/timezone|datetime.timezone]]</code> في بايثون. | ||
| + | |||
==مصادر== | ==مصادر== | ||
* [https://docs.python.org/3/library/datetime.html#tzinfo-objects. قسم tzinfo Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/datetime.html#tzinfo-objects. قسم tzinfo Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
مراجعة 21:18، 9 يوليو 2018
هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة، بل يجب اشتقاق صنف فرعي منه يتضمّن (على الأقل) توابع tzinfo القياسية التي ستُستخدم من طرف توابع الصنف datetime.
تقدّم وحدة datetime الصنف timezone وهو صنف فرعي محدّد concrete بسيط من الصنف tzinfo، يمكن عن طريقه تمثيل المناطق الزمنية باستخدام مقدار إزاحة ثابت عن التوقيت العالمي المنسّق، مثل التوقيت العالمي المنسّق نفسه، أو توقيتي EST و EDT في أمريكا الشمالية.
يمكن تمرير نسخة الصنف tzinfo (صنف فرعي محدّد منه) إلى الدوال البانية لكائنات datetime و time. تكون خصائص هذه الكائنات حسب التوقيت المحلّي، ويقدّم كائن tzinfo التوابع التي تحدّد مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق، واسم المنطقة الزمنية، ومقدار إزاحة التوقيت الصيفي DST في كائن التاريخ أو الوقت الممرّر إليها.
تتطلب عملية pickling وجود التابع __init__() في الصنف الفرعي للصنف tzinfo، ويجب أن يكون التابع قابلًا للاستدعاء دون وجود معاملات، وإلا فقد تجرى عملية pickling هذا المطلب تقني بحت وقد يكون بالإمكان التساهل فيه مستقبلًا.
قد يحتاج الصنف الفرعي المحدّد من tzinfo إلى استخدام التوابع التالية، ويعتمد استخدام التوابع على طريقة استخدام كائنات datetime الواعية، وفي حال عدم إمكانية تحديد التابع المطلوب، يمكن استخدام التوابع جميعها.
توابع الصنف tzinfo
التابع tzinfo.utcoffset()
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC.
التابع tzinfo.dst()
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
التابع tzinfo.tzname()
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية.
التابع tzinfo.fromutc()
يستدعى هذا التابع عند استخدام التابع datetime.astimezone() بالطريقة الافتراضية.
انظر أيضًا
الصنف datetime.date في بايثون.
الصنف datetime.time في بايثون.
الصنف datetime.datetime في بايثون.
الصنف datetime.timezone في بايثون.