التابع datetime.time() في بايثون
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time().
البنية العامة
datetime.fromtimestamp(timestamp, tz=None)
المعاملات
timestamp
سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime.
= tz
صنف فرعي من الصنف tzinfo، يحدّد المنطقة الزمنية.
يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له.
إن لم يأخذ المعامل tz القيمة None، فيجب أن تكون القيمة نسخة من صنف tzinfo فرعي، ويحوّل الختم الزمني إلى المنطقة الزمنية المعطاة. وفي هذه الحالة تكون النتيجة مكافئة للتعبير totz.fromutc(datetime.utcfromtimestamp(timestamp).replace(tzinfo=tz))
القيمة المعادة
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time().
يمكن للتابع fromtimestamp() أن يطلق الخطأ OverflowError إن كان الختم الزمني خارجًا عن نطاق القيم المدعوم بواسطة الدالة localtime() أو gmtime() في لغة C، ويطلق الخطأ OSError عند حدوث خطأ في تنفيذ الدالتين السابقتين.
من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038.
من الجدير بالذكر أنّ التابع fromtimestamp() يتجاهل الثواني الكبسية التي تستخدمهاالأنظمة التي لا تدعم صيغة POSIX في تمثيل الختم الزمني، وهكذا يمكن أن يكون هناك ختمان زمنيان يختلفان عن بعضهما البعض بثانية واحدة وينتج عنهما كائنا datetime متطابقين.
أمثلة
يبين المثال التالي آلية عمل التابع:
انظر أيضًا
مصادر
قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.