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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.timezone()‎</code> في بايثون}}</noinclude>
 
<noinclude>{{DISPLAYTITLE:الصنف <code>datetime.timezone()‎</code> في بايثون}}</noinclude>
 +
 +
الصنف <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> التوابع التالية:
 +
 +
=== التابع <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 في توثيق بايثون الرسمي.]
  
 
[[تصنيف: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 مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.

انظر أيضًا

مصادر

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