عرض مصدر Python/datetime/time/utcoffset

<noinclude>{{DISPLAYTITLE:التابع <code>time.utcoffset()‎</code> في بايثون}}</noinclude>

يحدّد التابع مقدار الإزاحة عن التوقيت العالمي المنسّق.

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

<syntaxhighlight lang="python3">
‎time.utcoffset()
</syntaxhighlight>

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

إن أخذ الكائن <code>tzinfo</code> القيمة <code>None</code>، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد <code>self.tzinfo.utcoffset(None)</code>‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة <code>None</code> أو كائن <code>timedelta</code> بفارق زمني لا يتجاوز اليوم الواحد.

'''ملاحظة''': في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق.

== أمثلة ==

يبين المثال التالي آلية عمل التابع:

<syntaxhighlight lang="python3">
‎>>> from datetime import time, tzinfo, timedelta
>>> class GMT1(tzinfo):
...     def utcoffset(self, dt):
...             return timedelta(hours=1)
... 
>>> t = time(12, 10, 30, tzinfo=GMT1())
>>> t
datetime.time(12, 10, 30, tzinfo=<__main__.GMT1 object at 0x7f74c82658d0>)
>>> gmt = GMT1()
>>> t.utcoffset()
datetime.timedelta(0, 3600)
>>> print(t.utcoffset())
1:00:00

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/datetime/time/dst|time.dst()‎]]</code>: التحكم في نظام التوقيت الصيفي.
* التابع <code>[[Python/datetime/time/tzname|time.tzname()‎]]</code>: يحدّد التابع اسم المنطقة  الزمنية.

== مصادر ==
[https://docs.python.org/3/library/datetime.html#datetime.time.utcoffset قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]