عرض مصدر Python/datetime/datetime/fromtimestamp

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

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع <code>time.time()‎</code>.
== البنية العامة ==

<syntaxhighlight lang="python3">
‎datetime.fromtimestamp(timestamp, tz=None)
</syntaxhighlight>

== المعاملات ==
=== <code>timestamp</code> ===

سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن <code>datetime</code>.

===<code>tz</code> ===

صنف فرعي من الصنف <code>tzinfo</code>، يحدّد المنطقة الزمنية.

يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن <code>datetime</code> المعاد كائنًا بسيطًا في حال إعطاء القيمة <code>None</code> إلى المعامل الاختياري <code>tz</code> أو في حال عدم تحديد أيّ قيمة له.

إن لم يأخذ المعامل <code>tz</code> القيمة <code>None</code>، فيجب أن تكون القيمة نسخة من صنف <code>tzinfo</code> فرعي، ويحوّل الختم الزمني إلى المنطقة الزمنية المعطاة. وفي هذه الحالة تكون النتيجة مكافئة للتعبير  <code>totz.fromutc(datetime.utcfromtimestamp(timestamp).replace(tzinfo=tz))‎</code>

== القيمة المعادة ==
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع <code>time.time()‎</code>.

يمكن للتابع <code>fromtimestamp()</code>‎ أن يطلق الخطأ <code>OverflowError</code> إن كان الختم الزمني خارجًا عن نطاق القيم المدعوم بواسطة الدالة <code>localtime()‎</code> أو <code>gmtime()‎</code> في لغة C، ويطلق الخطأ <code>OSError</code> عند حدوث خطأ في تنفيذ الدالتين السابقتين.

من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038.

من الجدير بالذكر أنّ التابع <code>fromtimestamp()</code>‎ يتجاهل الثواني الكبيسة التي تستخدمها الأنظمة التي لا تدعم صيغة POSIX في تمثيل الختم الزمني، وهكذا يمكن أن يكون هناك ختمان زمنيان يختلفان عن بعضهما البعض بثانية واحدة وينتج عنهما كائنا <code>datetime</code> متطابقين.

'''ملاحظة:''' في الإصدار 3.3، تطلق اللغة الخطأ <code>OverflowError</code> بدلًا من <code>ValueError</code> عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>localtime()‎</code> أو <code>gmtime()‎</code> في منصّة C.

وتطلق اللغة الخطأ <code>OSError</code> بدلًا من <code>ValueError</code> عند حدوث خطأ في تنفيذ الدالة <code>localtime()‎</code> أو <code>gmtime()‎</code>.

'''ملاحظة''': قد يعيد التابع <code>fromtimestamp()‎</code> نسخًا تكون قيمة المعامل <code>fold</code> فيها <code>1</code>.

== أمثلة ==

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

<syntaxhighlight lang="python3">
‎>>> from datetime import datetime
>>> import time
>>> posix = time.time()
>>> print(posix)
1530816709.908411
>>> dt = datetime.fromtimestamp(posix)
>>> print(dt)
2018-07-05 21:51:49.908411
</syntaxhighlight>

== انظر أيضًا ==
التابع <code>[[Python/datetime/datetime/utcfromtimestamp|datetime.utcfromtimestamp()]]</code>‎: يعيد التابع كائن <code>datetime</code> حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني المعطى.

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

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