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

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم 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 متطابقين.

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

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

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

أمثلة

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

‎>>> 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

انظر أيضًا

التابع datetime.utcfromtimestamp()‎: يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني المعطى.

مصادر

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