الفرق بين المراجعتين لصفحة: «Python/datetime/tzinfo/tzname»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>tzinfo.tzname()</code> في بايثون}}</noinclude> يعيد التابع اسم المنطقة الزمنية الخ...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>tzinfo.tzname()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>tzinfo.tzname()</code> في بايثون}}</noinclude> | ||
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية. | يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن <code>datetime</code> على هيئة سلسلة نصية. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 11: | سطر 11: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية. | يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن <code>datetime</code> على هيئة سلسلة نصية. | ||
لا يجري تعريف أيّ شيء بخصوص أسماء السلاسل النصية بواسطة الوحدة | لا يجري تعريف أيّ شيء بخصوص أسماء السلاسل النصية بواسطة الوحدة <code>datetime</code>، وليس من المطلوب أن يحمل الاسم دلالة معيّنة. فعلى سبيل المثال تعدّ السلاسل النصية التالية كلّها صحيحة: "GMT" و "UTC" و "-500" و "-5:00" و "EDT" و "US/Eastern" و "America/New York". يعيد التابع القيمة <code>None</code> إن كان اسم السلسلة النصية غير معروف. | ||
يجب الانتباه إلى أنّ هذا تابع وليس سلسلة نصية ثابتة، والسبب الرئيسي هو أنّ بعض الأصناف الفرعية من tzinfo ستعيد أسماء مختلفة بالاعتماد على قيمة dt الممرّرة إليها، وخصوصًا إن كان أخذ الصنف tzinfo التوقيت الصيفي بالحسبان. | يجب الانتباه إلى أنّ هذا تابع وليس سلسلة نصية ثابتة، والسبب الرئيسي هو أنّ بعض الأصناف الفرعية من <code>tzinfo</code> ستعيد أسماء مختلفة بالاعتماد على قيمة <code>dt</code> الممرّرة إليها، وخصوصًا إن كان أخذ الصنف <code>tzinfo</code> التوقيت الصيفي بالحسبان. | ||
يؤدي استخدام التابع tzname() بالطريقة الافتراضية إلى إطلاق الخطأ NotImplementedError. | يؤدي استخدام التابع <code>tzname()</code> بالطريقة الافتراضية إلى إطلاق الخطأ <code>NotImplementedError</code>. | ||
تستدعى هذه التوابع بواسطة كائن datetime أو time وذلك استجابة للتوابع التي تحمل الأسماء ذاتها في هذه الكائنات. يمرّر كائن datetime نفسه كمعامل، في حين يمرّر الكائن time القيمة None كمعامل؛ ولهذا يجب تحضير توابع الصنف الفرعي للصنف tzinfo لاستقبال معامل dt قيمته None أو صنف datetime. | تستدعى هذه التوابع بواسطة كائن <code>datetime</code> أو <code>time</code> وذلك استجابة للتوابع التي تحمل الأسماء ذاتها في هذه الكائنات. يمرّر كائن <code>datetime</code> نفسه كمعامل، في حين يمرّر الكائن <code>time</code> القيمة <code>None</code> كمعامل؛ ولهذا يجب تحضير توابع الصنف الفرعي للصنف <code>tzinfo</code> لاستقبال معامل <code>dt</code> قيمته <code>None</code> أو صنف <code>datetime</code>. | ||
عند تمرير القيمة None فإنّ الأمر القرار يكون بيد منشئ الصنف لاختيار الاستجابة المناسبة. فمثلًا إعادة القيمة None تكون مناسبة إن كان المطلوب هو عدم مشاركة كائنات الوقت time في بروتوكولات الكائن tzinfo. ومن المفيد بالنسبة للتابع utcoffset(None) أن يعيد مقدار الإزاحة المعياري عن التوقيت العالمي المنسق، وذلك نظرًا لعدم وجود أي طريقة أخرى لتحديد مقدار الإزاحة المعياري. | عند تمرير القيمة <code>None</code> فإنّ الأمر القرار يكون بيد منشئ الصنف لاختيار الاستجابة المناسبة. فمثلًا إعادة القيمة <code>None</code> تكون مناسبة إن كان المطلوب هو عدم مشاركة كائنات الوقت time في بروتوكولات الكائن <code>tzinfo</code>. ومن المفيد بالنسبة للتابع <code>utcoffset(None)</code> أن يعيد مقدار الإزاحة المعياري عن التوقيت العالمي المنسق، وذلك نظرًا لعدم وجود أي طريقة أخرى لتحديد مقدار الإزاحة المعياري. | ||
عند تمرير كائن <code>datetime</code> كاستجابة لأحد توابع الكائن <code>datetime</code>، يكون الكائن <code>dt.tzinfo</code> مماثلًا للكائن <code>self.tzinfo</code>، إلا إذا كانت الشيفرة المكتوبة من قبل المستخدم تستدعي التابع <code>tzinfo</code> بصورة مباشرة. الهدف هنا هو أن تفسّر توابع <code>tzinfo</code> الكائن <code>dt</code> على أنّه ضمن التوقيت المحلي دون الحاجة إلى الاهتمام بالكائنات في المناطق الزمنية الأخرى. | |||
== انظر أيضًا == | == انظر أيضًا == | ||
التابع <code>[[Python/datetime/tzinfo/dst|tzinfo.dst()]]</code>: يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST). | |||
== مصادر == | == مصادر == | ||
مراجعة 20:25، 10 يوليو 2018
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية.
البنية العامة
tzinfo.tzname(dt)
القيمة المعادة
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية.
لا يجري تعريف أيّ شيء بخصوص أسماء السلاسل النصية بواسطة الوحدة datetime، وليس من المطلوب أن يحمل الاسم دلالة معيّنة. فعلى سبيل المثال تعدّ السلاسل النصية التالية كلّها صحيحة: "GMT" و "UTC" و "-500" و "-5:00" و "EDT" و "US/Eastern" و "America/New York". يعيد التابع القيمة None إن كان اسم السلسلة النصية غير معروف.
يجب الانتباه إلى أنّ هذا تابع وليس سلسلة نصية ثابتة، والسبب الرئيسي هو أنّ بعض الأصناف الفرعية من tzinfo ستعيد أسماء مختلفة بالاعتماد على قيمة dt الممرّرة إليها، وخصوصًا إن كان أخذ الصنف tzinfo التوقيت الصيفي بالحسبان.
يؤدي استخدام التابع tzname() بالطريقة الافتراضية إلى إطلاق الخطأ NotImplementedError.
تستدعى هذه التوابع بواسطة كائن datetime أو time وذلك استجابة للتوابع التي تحمل الأسماء ذاتها في هذه الكائنات. يمرّر كائن datetime نفسه كمعامل، في حين يمرّر الكائن time القيمة None كمعامل؛ ولهذا يجب تحضير توابع الصنف الفرعي للصنف tzinfo لاستقبال معامل dt قيمته None أو صنف datetime.
عند تمرير القيمة None فإنّ الأمر القرار يكون بيد منشئ الصنف لاختيار الاستجابة المناسبة. فمثلًا إعادة القيمة None تكون مناسبة إن كان المطلوب هو عدم مشاركة كائنات الوقت time في بروتوكولات الكائن tzinfo. ومن المفيد بالنسبة للتابع utcoffset(None) أن يعيد مقدار الإزاحة المعياري عن التوقيت العالمي المنسق، وذلك نظرًا لعدم وجود أي طريقة أخرى لتحديد مقدار الإزاحة المعياري.
عند تمرير كائن datetime كاستجابة لأحد توابع الكائن datetime، يكون الكائن dt.tzinfo مماثلًا للكائن self.tzinfo، إلا إذا كانت الشيفرة المكتوبة من قبل المستخدم تستدعي التابع tzinfo بصورة مباشرة. الهدف هنا هو أن تفسّر توابع tzinfo الكائن dt على أنّه ضمن التوقيت المحلي دون الحاجة إلى الاهتمام بالكائنات في المناطق الزمنية الأخرى.
انظر أيضًا
التابع tzinfo.dst(): يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
مصادر
قسم tzinfo Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.