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

يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None.

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

datetime.utcfromtimestamp(timestamp)

المعاملات

timestamp

سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime.

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

يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None.

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

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

يمكن الحصول على كائن datetmie واعٍ باستدعاء التابع fromtimestamp()‎:

datetime.fromtimestamp(timestamp, timezone.utc)

التعبير السابق مكافئ للتعبير التالي في المنصّات التي تدعم صيغة POSIX:

datetime(1970, 1, 1, tzinfo=timezone.utc) + timedelta(seconds=timestamp)

باستثناء أنّ الصيغة الأخيرة تدعم نطاق السنوات الكامل: بين MINYEAR و MAXYEAR ضمنيًّا.

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

أمثلة

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

>>> from datetime import datetime
>>> from time import time
>>> dt = datetime.utcfromtimestamp(time.time())
>>> print(dt)
2018-07-05 19:03:59.988065

انظر أيضًا

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

مصادر

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