التابع date.fromtimestamp()‎ في بايثون

يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎.

المعاملات

=== timestamp

الختم الزمني بصيغة POSIX والمراد معرفة التاريخ المحلي الموافق له. يعيد التابع time.time()‎ ختمًا زمنيًا بصيغة POSIX.

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

إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة localtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverFlowError، وإن حدث خطأ في تنفيذ الدالة localtime()‎ فإنّ التابع يطلق الخطأ OSError.

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

من الجدير بالذكر أنّ التابع fromtimestamp()‎ يتجاهل الثواني الكبسية التي تستخدمهاالأنظمة التي لا تدعم صيغة POSIX في تمثيل الختم الزمني.

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

أمثلة

يبين المثال التالي طريقة استخدام هذا التابع:

‎>>> import time
>>> from datetime import date
>>> today = date.today()
>>> today
datetime.date(2007, 12, 5)
>>> today == date.fromtimestamp(time.time())
True