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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.tzinfo()‎</code> في بايثون}}</noinclude> هذا الصنف هو صنف أساسي مجرّد abstract base...')
 
 
(4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.tzinfo()‎</code> في بايثون}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.timezone()‎</code> في بايثون}}</noinclude>
  
−
هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة، بل يجب اشتقاق صنف فرعي منه يتضمّن (على الأقل) توابع tzinfo القياسية التي ستُستخدم من طرف توابع الصنف datetime.
+
الصنف <code>timezone</code> هو صنف فرعي من الصنف <code>[[Python/datetime/tzinfo|tzinfo]]</code>، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق.
  
 +
يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية.
  
 
== البنية العامة ==
 
== البنية العامة ==
−
 
 
<syntaxhighlight lang="python3">
 
<syntaxhighlight lang="python3">
−
‎datetime.tzinfo
+
class datetime.timezone(offset, name=None)
 
</syntaxhighlight>
 
</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>.
  
−
تقدّم وحدة datetime الصنف timezone وهو صنف فرعي محدّد concrete بسيط من الصنف tzinfo، يمكن عن طريقه تمثيل المناطق الزمنية باستخدام مقدار إزاحة ثابت عن التوقيت العالمي المنسّق، مثل التوقيت العالمي المنسّق نفسه، أو توقيتي EST و EDT في أمريكا الشمالية.
+
'''ملاحظات:'''
 +
* هذا الصنف جديد في الإصدار 3.2 من بايثون.
  
−
يمكن تمرير نسخة الصنف tzinfo (صنف فرعي محدّد منه) إلى الدوال البانية لكائنات datetime و time. تكون خصائص هذه الكائنات حسب التوقيت المحلّي، ويقدّم كائن tzinfo التوابع التي تحدّد مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق، واسم المنطقة الزمنية، ومقدار إزاحة التوقيت الصيفي DST في كائن التاريخ أو الوقت الممرّر إليها.
+
* لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة.
  
−
تتطلب عملية pickling وجود التابع ‎__init__()‎ في الصنف الفرعي للصنف tzinfo، ويجب أن يكون التابع قابلًا للاستدعاء دون وجود معاملات، وإلا فقد تجرى عملية pickling
+
== خصائص الصنف <code>timezone</code> ==
−
هذا المطلب تقني بحت وقد يكون بالإمكان التساهل فيه مستقبلًا.
+
يقدّم الصنف <code>timezone</code> خاصّية واحدة فقط:
  
−
قد يحتاج الصنف الفرعي المحدّد من tzinfo إلى استخدام التوابع التالية، ويعتمد استخدام التوابع على طريقة استخدام كائنات datetime الواعية، وفي حال عدم إمكانية تحديد التابع المطلوب، يمكن استخدام التوابع جميعها.
+
=== <code>timezone.utc</code> ===
 +
المنطقة الزمنية UTC، وتكافئ التعبير <code>timezone(timedelta(0))‎</code>.
  
−
== توابع الصنف <code>tzinfo</code> ==
+
== توابع الصنف <code>timezone</code> ==
  
−
=== التابع <code>tzinfo.utcoffset()‎</code> ===
+
يقدّم الصنف <code>timezone</code> التوابع التالية:
−
يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC.
 
  
−
=== التابع <code>tzinfo.dst()‎</code> ===
+
=== التابع <code>[[Python/datetime/timezone/utcoffset|timezone.utcoffset()]]‎</code> ===
−
يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).
+
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>.
  
−
=== التابع <code>tzinfo.tzname()‎</code> ===
+
=== التابع <code>[[Python/datetime/timezone/tzname|timezone.tzname()‎]]</code> ===
−
يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية.
+
يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف <code>timezone</code>.
  
−
=== التابع <code>tzinfo.fromutc()‎</code> ===
+
=== التابع <code>timezone.dst()‎</code> ===
−
ستدعى هذا التابع عند استخدام التابع datetime.astimezone()‎ بالطريقة الافتراضية.  
+
يعيد القيمة <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#tzinfo-objects. قسم tzinfo 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]]
−
[[تصنيف:Python Methods]]
 

المراجعة الحالية بتاريخ 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 مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.

انظر أيضًا

مصادر

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