الفرق بين المراجعتين ل"Python/datetime/timezone/utcoffset"
اذهب إلى التنقل
اذهب إلى البحث
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE:التابع <code> | + | <noinclude>{{DISPLAYTITLE:التابع <code>timezone.utcoffset()</code> في بايثون}}</noinclude> |
− | يعيد التابع القيمة الثابتة | + | يعيد التابع القيمة الثابتة لمقدار الإزاحة عن التوقيت العالمي المنسّق والتي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. |
== البنية العامة == | == البنية العامة == | ||
سطر 20: | سطر 20: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
+ | >>> from datetime import datetime, timedelta, timezone | ||
+ | >>> AST = timezone(timedelta(hours=3), name="Arabia Standard Time") | ||
+ | >>> dt = datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST) | ||
+ | >>> print(dt) | ||
+ | 2018-07-11 00:21:12+03:00 | ||
+ | >>> dt.tzname() | ||
+ | 'Arabia Standard Time' | ||
+ | >>> AST.utcoffset(dt) | ||
+ | datetime.timedelta(0, 10800) | ||
+ | >>> print(AST.utcoffset(dt)) | ||
+ | 3:00:00 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
+ | * التابع <code>[[Python/datetime/timezone/tzname|timezone.tzname()]]</code>: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
+ | * التابع <code>[[Python/datetime/timezone/fromutc|timezone.fromutc()]]</code>: يعيد التابع قيمة كائن <code>datetime</code> مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق. | ||
== مصادر == | == مصادر == | ||
− | [https://docs.python.org/3/library/datetime.html#datetime.timezone.utcoffset قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | + | * [https://docs.python.org/3/library/datetime.html#datetime.timezone.utcoffset قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] |
− | |||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] |
المراجعة الحالية بتاريخ 21:54، 10 يوليو 2018
يعيد التابع القيمة الثابتة لمقدار الإزاحة عن التوقيت العالمي المنسّق والتي جرى تحديدها عند بناء نسخة الصنف timezone
.
البنية العامة
timezone.utcoffset(dt)
القيمة المعادة
يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone
، ويجري تجاهل المعامل dt
.
تكون القيمة المعادة عبارة عن نسخة من الصنف timedelta
مساوية لفارق التوقيت بين التوقيت المحلي والتوقيت العالمي المنسّق.
ملاحظة: لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> from datetime import datetime, timedelta, timezone
>>> AST = timezone(timedelta(hours=3), name="Arabia Standard Time")
>>> dt = datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST)
>>> print(dt)
2018-07-11 00:21:12+03:00
>>> dt.tzname()
'Arabia Standard Time'
>>> AST.utcoffset(dt)
datetime.timedelta(0, 10800)
>>> print(AST.utcoffset(dt))
3:00:00
انظر أيضًا
- التابع
timezone.tzname()
: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنفtimezone
. - التابع
timezone.fromutc()
: يعيد التابع قيمة كائنdatetime
مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.