عرض مصدر Python/datetime/tzinfo/fromutc

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

يستدعى هذا التابع عند استخدام التابع <code>datetime.astimezone()‎</code> بالطريقة الافتراضية. وعند استدعائه من هناك، يكون <code>[[Python/datetime/tzinfo|dt.tzinfo]]</code> هو الكائن نفسه <code>self</code>، ويُنظر إلى بيانات التاريخ والوقت في الكائن <code>dt</code> على أنّها تعرض الوقت حسب التوقيت العالمي المنسّق. 

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

<syntaxhighlight lang="python3">
‎tzinfo.fromutc(dt)
</syntaxhighlight>

الهدف من التابع <code>formutc()</code>‎ هو تعديل بيانات الوقت والتاريخ وإعادة كائن <code>datetime</code> مكافئ حسب التوقيت المحليّ للكائن نفسه <code>self</code>.

يجب على الأصناف الفرعية من <code>tzinfo</code> أن تكون قادرةً على وراثة طريقة الاستخدام الافتراضية للتابع <code>fromutc()‎</code> دون أي مشاكل، وذلك لأنّ هذا التابع قادرٌ على التعامل مع حالات مثل المناطق الزمنية ذات مقدار الإزاحة الثابتة، والمناطق الزمنية التي تعتمد التوقيتين المعياري والصيفي، أو التوقيت الصيفي حتى عندما تكون أوقات الانتقال في النظام الصيفي مختلفة من سنة إلى أخرى. 

ولكن قد لا يمكن للطريقة الافتراضية في استخدام التابع <code>fromutc()‎</code> أن تتعامل مع بعض الحالات على نحو صحيح، فمثلًا عندما لا يعتمد مقدار الإزاحة المعياري عن التوقيت العالمي المنسّق على تاريخ أو وقت معين، وهو أمر قد يحدث لأسباب سياسية. ما يحدث هنا هو أنّه قد لا تعطي الطريقة الافتراضية لاستخدام التابعين <code>[[Python/datetime/datetime/astimezone|astimezone()‎]]</code> و <code>fromutc()</code>‎  النتائج المطلوبة إن كانت النتيجة هي ساعة تكون ضمن اللحظة التي يحدث بها تغير في مقدار الإزاحة المعياري.

== أمثلة ==

لو تجاوزنا الحالات التي تنشأ عنها الأخطاء فإنّ الطريقة الافتراضية لاستخدام التابع <code>fromutc()‎</code> هي:

<syntaxhighlight lang="python3">

def fromutc(self, dt):
	# يطلق الخطأ ValueError إن لم يكن dt.tzinfo هو self
    dtoff = dt.utcoffset()
    dtdst = dt.dst()
	# يطلق الخطأ ValueError إن لم يكن dtoff هو None أو لم يكن dtdst هو None
    delta = dtoff - dtdst  # هذا هو مقدار الإزاحة المعياري للكائن نفسه
    if delta:
        dt += delta   # التحويل إلى التوقيت المحلي المعياري
        dtdst = dt.dst()
        # يطلق الخطأ ValueError إن كان dtdst يحمل القيمة None
    if dtdst:
        return dt + dtdst
    else:
        return dt

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/datetime/tzinfo/dst|tzinfo.dst()‎]]</code>: يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST).

* التابع <code>[[Python/datetime/datetime/astimezone|datetime.astimezone()‎]]</code>: يعيد التابع كائن <code>datetime</code> مع خاصية <code>tzinfo</code> الممرّرة كمعامل للتابع، ويَجري تعديل بيانات الوقت والتاريخ بحيث تكون النتيجة مشابهة لوقت الكائن نفسه حسب التوقيت العالمي المنسّق، ولكنّ بالتوقيت المحلّي المحدّد بالمعامل <code>tz</code>.

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

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