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

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

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

date.fromtimestamp(timestamp)

المعاملات

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

انظر أيضًا

• التابع date.today()‎ : يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية.
• التابع date.fromordinal()‎: يعيد هذا التابع التاريخ بحسب العدد الترتيبي المعطى والتابع للتقويم الكريكوري التنبؤي.

مصادر

• قسم date Object في صفحة Basic date and time types في توثيق بايثون الرسمي.