الفرق بين المراجعتين ل"Python/datetime/tzinfo/dst"

من موسوعة حسوب
< Python‏ | datetime‏ | tzinfo
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()‎</code> في بايثون}}</noinclude> == البنية العامة == <syntaxhighlight lang="python3"...')
 
 
(4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()‎</code> في بايثون}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:التابع <code>tzinfo.dst()‎</code> في بايثون}}</noinclude>
−
 
 
  
 +
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
 
== البنية العامة ==
 
== البنية العامة ==
  
سطر 12: سطر 12:
 
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
 
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
  
−
يعيد التابع كائن timedelta يمثّل مقدار التعديل لنظام التوقيت الصيفي (DST)، ويعيد القيمة None إن لم تكن معلومات التوقيت الصيفي معروفة، ويعيد timedelta(0)‎ إن لم يكن التوقيت الصيفي مفعّلًا. أما لو كان التوقيت الصيفي مفعّلًا، فإنّ التابع يعيد كائن timedelta (راجع التابع utcoffset()‎ للمزيد من التفاصيل).
+
يعيد التابع كائن timedelta يمثّل مقدار التعديل لنظام التوقيت الصيفي (DST)، ويعيد القيمة <code>None</code> إن لم تكن معلومات التوقيت الصيفي معروفة، ويعيد <code>timedelta(0)‎</code> إن لم يكن التوقيت الصيفي مفعّلًا. أما لو كان التوقيت الصيفي مفعّلًا، فإنّ التابع يعيد كائن <code>[[Python/datetime/timedelta|timedelta]]</code> (راجع التابع <code>[[Python/datetime/tzinfo/utcoffset|utcoffset()]]</code>‎ للمزيد من التفاصيل).
 +
 
 +
يجب الانتباه إلى أنّ مقدار إزاحة التوقيت الصيفي - إن كان مطبّقًا - مضاف مسبقًا إلى مقدار الإزاحة عن التوقيت العالمي المنسّق والذي يعيده التابع <code>[[Python/datetime/tzinfo/utcoffset|utcoffset()]]</code>‎، لهذا لا حاجة إلى استدعاء التابع <code>dst()</code>‎ إلا إذا كان المطلوب الحصول على معلومات التوقيت الصيفي على نحو منفصل.
 +
 
 +
فعلى سبيل المثال يستدعي التابع <code>[[Python/datetime/datetime/timetuple|datetime.timetuple()]]</code>‎ التابع <code>dst()‎</code> وهو من توابع خاصّيته <code>tzinfo</code> لتحديد طريقة تعيين قيمة الراية <code>tm_isdst</code>، ويستدعي التابع <code>[[Python/datetime/tzinfo/fromutc|tzinfo.fromutc()‎]]</code> التابع <code>dst()</code>‎ عند الانتقال بين المناطق الزمنية للأخذ بالحسبان التغييرات التي قد تطرأ على التوقيت بسبب نظام التوقيت الصيفي.
 +
 
 +
يجب أن تكون نسخة الصنف الفرعي للصنف <code>tzinfo</code> (لنفترض أنها <code>tz</code>) والتي تمثّل التوقيتين المعياري والصيفي متّسقة ومطابقة للمفهوم التالي:
 +
 
 +
يجب أن يعيد التعبير: <code>tz.utcoffset(dt) - tz.dst(dt)‎</code> النتيجة نفسها لأي كائن <code>[[Python/datetime/datetime|datetime]]</code> تكون فيه <code>dt.tzinfo == tz</code>.
 +
 
 +
يعيد هذا التعبير في الأصناف الفرعية  السليمة من <code>tzinfo</code> مقدار الإزاحة المعياري "standard offset" للمنطقة الزمنية والذي يجب أن لا يعتمد على التاريخ أو الوقت، ولكن على المنطقة الزمنية فقط.  
  
−
يجب الانتباه إلى أنّ مقدار إزاحة التوقيت الصيفي - إن كان مطبّقًا - مضاف مسبقًا إلى مقدار الإزاحة عن التوقيت العالمي المنسّق والذي يعيده التابع utcoffset()‎، لهذا لا حاجة إلى استدعاء التابع dst()‎ إلا إذا كان المطلوب الحصول على معلومات التوقيت الصيفي على نحو منفصل.
+
يعتمد التابع <code>[[Python/datetime/datetime/astimezone|datetime.astimezone()]]</code>‎ على هذا الأمر، ولكنّه غير قادر على اكتشاف المخالفات، وتقع مسؤولية ذلك على عاتق المبرمج.
  
−
فعلى سبيل المثال يستدعي التابع datetime.timetuple()‎ التابع dst()‎ وهو من توابع خاصّيته tzinfo لتحديد طريقة تعيين قيمة الراية tm_isdst، ويستدعي التابع tzinfo.fromutc()‎ التابع dst()‎ عند الانتقال بين المناطق الزمنية للأخذ بالحسبان التغييرات التي قد تطرأ على التوقيت بسبب نظام التوقيت الصيفي.
+
إن لم يضمن الصنف الفرعي من <code>tzinfo</code> ذلك، فقد يكون بمقدوره إعادة تعريف طريقة الاستخدام الافتراضية للتابع <code>[[Python/datetime/tzinfo/fromutc|tzinfo.fromutc()]]</code>‎ ليعمل بصورة صحيحة مع التابع <code>[[Python/datetime/datetime/astimezone|astimezone()‎]]</code>.
  
−
يجب أن تكون نسخة الصنف الفرعي للصنف tzinfo (لنفترض أنها tz) والتي تمثّل التوقيتين المعياري والصيفي متّسقة ومطابقة للمفهوم التالي:
+
يؤدي استخدام التابع <code>dst()‎</code> بالطريقة الافتراضية إلى إطلاق الخطأ <code>NotImplementedError</code>.
−
يجب أن يعيد التعبير: <code>tz.utcoffset(dt) - tz.dst(dt)</code> النتيجة نفسها لأي كائن datetime تكون فيه dt.tzinfo == tz.
 
  
−
يعيد هذا التعبير في الأصناف الفرعية  السليمة من tzinfo مقدار الإزاحة المعياري "standard offset" للمنطقة الزمنية والذي يجب أن لا يعتمد على التاريخ أو الوقت، ولكن على المنطقة الزمنية فقط.  
+
'''ملاحظة''': لم يعد مقدار إزاحة التوقيت الصيفي مقصورًا على الأعداد الصحيحة للدقائق.
  
−
يعتمد التابع datetime.astimezone()‎ على هذا الأمر، ولكنّه غير قادر على اكتشاف المخالفات، وتقع مسؤولية ذلك على عاتق المبرمج.
+
== أمثلة ==
  
−
إن لم يضمن الصنف الفرعي من tzinfo ذلك، فقد يكون بمقدوره إعادة تعريف طريقة الاستخدام الافتراضية للتابع tzinfo.fromutc()‎ ليعمل بصورة صحيحة مع التابع astimezone()‎.
+
عادة ما يستخدم التابع <code>dst()</code>‎ بإحدى الطريقتين التاليتين:
  
−
عادة ما يستخدم التابع dst()‎ بإحدى الطريقتين التاليتين:
+
الطريقة الأولى:
  
 
<syntaxhighlight lang="python3">
 
<syntaxhighlight lang="python3">
سطر 33: سطر 42:
 
     # صنف ذو مقدار إزاحة ثابت: لا يجري حساب DST
 
     # صنف ذو مقدار إزاحة ثابت: لا يجري حساب DST
 
     return timedelta(0)
 
     return timedelta(0)
−
</syntaxhighlight>
+
</syntaxhighlight>الطريقة الثانية:<syntaxhighlight lang="python3">
−
 
 
−
 
 
−
<syntaxhighlight lang="python3">
 
 
def dst(self, dt):
 
def dst(self, dt):
 
     # تعيين dston و dstoff لأوقات الانتقال في نظام التوقيت الصيفي
 
     # تعيين dston و dstoff لأوقات الانتقال في نظام التوقيت الصيفي
سطر 45: سطر 51:
 
     else:
 
     else:
 
         return timedelta(0)
 
         return timedelta(0)
−
</syntaxhighlight>
 
−
 
−
يؤدي استخدام التابع dst()‎ بالطريقة الافتراضية إلى إطلاق الخطأ NotImplementedError.
 
−
 
−
'''ملاحظة''': لم يعد مقدار إزاحة التوقيت الصيفي مقصورًا على الأعداد الصحيحة للدقائق.
 
−
 
−
== أمثلة ==
 
−
 
−
يبين المثال التالي آلية عمل التابع:
 
−
 
−
<syntaxhighlight lang="python3">
 
−
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
 +
* التابع <code>[[Python/datetime/datetime/dst|datetime.dst()‎]]</code>: يتيح التابع القدرة على تحديد ما إذا كان التوقيت الصيفي مستخدمًا أم لا.
 +
* التابع <code>[[Python/datetime/datetime/astimezone|datetime.astimezone()‎]]</code>: يعيد التابع كائن <code>datetime</code> مع خاصية <code>tzinfo</code> الممرّرة كمعامل للتابع، ويَجري تعديل بيانات الوقت والتاريخ بحيث تكون النتيجة مشابهة لوقت الكائن نفسه حسب التوقيت العالمي المنسّق، ولكنّ بالتوقيت المحلّي المحدّد بالمعامل <code>tz</code>.
  
 
== مصادر ==
 
== مصادر ==
−
[https://docs.python.org/3/library/datetime.html#datetime.datetime. قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]
+
* [https://docs.python.org/3/library/datetime.html#datetime.tzinfo.dst قسم tzinfo Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]
−
 
 
 
[[تصنيف:Python]]
 
[[تصنيف:Python]]
 
[[تصنيف:Python Modules]]
 
[[تصنيف:Python Modules]]
 
[[تصنيف:Python Methods]]
 
[[تصنيف:Python Methods]]

المراجعة الحالية بتاريخ 20:33، 10 يوليو 2018


يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).

البنية العامة

‎tzinfo.dst(dt)

القيمة المعادة

يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).

يعيد التابع كائن timedelta يمثّل مقدار التعديل لنظام التوقيت الصيفي (DST)، ويعيد القيمة None إن لم تكن معلومات التوقيت الصيفي معروفة، ويعيد timedelta(0)‎ إن لم يكن التوقيت الصيفي مفعّلًا. أما لو كان التوقيت الصيفي مفعّلًا، فإنّ التابع يعيد كائن timedelta (راجع التابع utcoffset()‎ للمزيد من التفاصيل).

يجب الانتباه إلى أنّ مقدار إزاحة التوقيت الصيفي - إن كان مطبّقًا - مضاف مسبقًا إلى مقدار الإزاحة عن التوقيت العالمي المنسّق والذي يعيده التابع utcoffset()‎، لهذا لا حاجة إلى استدعاء التابع dst()‎ إلا إذا كان المطلوب الحصول على معلومات التوقيت الصيفي على نحو منفصل.

فعلى سبيل المثال يستدعي التابع datetime.timetuple()‎ التابع dst()‎ وهو من توابع خاصّيته tzinfo لتحديد طريقة تعيين قيمة الراية tm_isdst، ويستدعي التابع tzinfo.fromutc()‎ التابع dst()‎ عند الانتقال بين المناطق الزمنية للأخذ بالحسبان التغييرات التي قد تطرأ على التوقيت بسبب نظام التوقيت الصيفي.

يجب أن تكون نسخة الصنف الفرعي للصنف tzinfo (لنفترض أنها tz) والتي تمثّل التوقيتين المعياري والصيفي متّسقة ومطابقة للمفهوم التالي:

يجب أن يعيد التعبير: tz.utcoffset(dt) - tz.dst(dt)‎ النتيجة نفسها لأي كائن datetime تكون فيه dt.tzinfo == tz.

يعيد هذا التعبير في الأصناف الفرعية السليمة من tzinfo مقدار الإزاحة المعياري "standard offset" للمنطقة الزمنية والذي يجب أن لا يعتمد على التاريخ أو الوقت، ولكن على المنطقة الزمنية فقط.

يعتمد التابع datetime.astimezone()‎ على هذا الأمر، ولكنّه غير قادر على اكتشاف المخالفات، وتقع مسؤولية ذلك على عاتق المبرمج.

إن لم يضمن الصنف الفرعي من tzinfo ذلك، فقد يكون بمقدوره إعادة تعريف طريقة الاستخدام الافتراضية للتابع tzinfo.fromutc()‎ ليعمل بصورة صحيحة مع التابع astimezone()‎.

يؤدي استخدام التابع dst()‎ بالطريقة الافتراضية إلى إطلاق الخطأ NotImplementedError.

ملاحظة: لم يعد مقدار إزاحة التوقيت الصيفي مقصورًا على الأعداد الصحيحة للدقائق.

أمثلة

عادة ما يستخدم التابع dst()‎ بإحدى الطريقتين التاليتين:

الطريقة الأولى: 

def dst(self, dt):
    # صنف ذو مقدار إزاحة ثابت: لا يجري حساب DST
    return timedelta(0)

الطريقة الثانية:

def dst(self, dt):
    # تعيين dston و dstoff لأوقات الانتقال في نظام التوقيت الصيفي
	# الخاص بمنطقة زمنية معينة وذلك بالاستناد إلى السنة dt.year
	# ويُعرض بالتوقيت المعياري المحلّي.
    if dston <= dt.replace(tzinfo=None) < dstoff:
        return timedelta(hours=1)
    else:
        return timedelta(0)

انظر أيضًا

  • التابع datetime.dst()‎: يتيح التابع القدرة على تحديد ما إذا كان التوقيت الصيفي مستخدمًا أم لا.
  • التابع datetime.astimezone()‎: يعيد التابع كائن datetime مع خاصية tzinfo الممرّرة كمعامل للتابع، ويَجري تعديل بيانات الوقت والتاريخ بحيث تكون النتيجة مشابهة لوقت الكائن نفسه حسب التوقيت العالمي المنسّق، ولكنّ بالتوقيت المحلّي المحدّد بالمعامل tz.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Python/datetime/tzinfo/dst&oldid=12738"