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