التابع 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(): يعيد هذا التابع التاريخ بحسب العدد الترتيبي المعطى والتابع للتقويم الكريكوري التنبؤي.