الفرق بين المراجعتين ل"Python/datetime/datetime/utcfromtimestamp"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.utcfromtimestamp()</code> في بايثون}}</noinclude> يعيد التابع كائن datetime حسب الت...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.utcfromtimestamp()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.utcfromtimestamp()</code> في بايثون}}</noinclude> | ||
| − | يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. | + | يعيد التابع كائن <code>datetime</code> حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء <code>tzinfo</code> القيمة <code>None</code>. |
== البنية العامة == | == البنية العامة == | ||
| سطر 15: | سطر 15: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| − | يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. | + | يعيد التابع كائن <code>datetime</code> حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء <code>tzinfo</code> القيمة <code>None</code>. |
| − | إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة gmtime() في منصّة C، فإنّ التابع يطلق الخطأ | + | إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>gmtime()</code> في منصّة C، فإنّ التابع يطلق الخطأ <code>OverflowError</code>، وإن حدث خطأ في تنفيذ الدالة <code>gmtime()</code> فإنّ التابع يطلق الخطأ <code>OSError</code>. |
من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038. | من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038. | ||
| − | يمكن الحصول على كائن datetmie واعٍ باستدعاء التابع fromtimestamp(): | + | يمكن الحصول على كائن <code>datetmie</code> واعٍ باستدعاء التابع <code>fromtimestamp()</code>: |
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| سطر 33: | سطر 33: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | باستثناء أنّ الصيغة الأخيرة تدعم نطاق السنوات الكامل: بين MINYEAR و MAXYEAR ضمنيًّا. | + | باستثناء أنّ الصيغة الأخيرة تدعم نطاق السنوات الكامل: بين <code>MINYEAR</code> و <code>MAXYEAR</code> ضمنيًّا. |
| − | '''ملاحظة''': في الإصدار 3.3، تطلق اللغة الخطأ OverflowError بدلًا من ValueError عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة gmtime() في منصّة C. وتطلق اللغة الخطأ OSError بدلًا من ValueError عند حدوث خطأ في تنفيذ الدالة gmtime(). | + | '''ملاحظة''': في الإصدار 3.3، تطلق اللغة الخطأ <code>OverflowError</code> بدلًا من <code>ValueError</code> عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>gmtime()</code> في منصّة C. وتطلق اللغة الخطأ <code>OSError</code> بدلًا من <code>ValueError</code> عند حدوث خطأ في تنفيذ الدالة <code>gmtime()</code>. |
== أمثلة == | == أمثلة == | ||
| سطر 51: | سطر 51: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | التابع <code>[[Python/datetime/datetime/fromtimestamp|datetime.fromtimestamp()]]</code>: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time(). | + | التابع <code>[[Python/datetime/datetime/fromtimestamp|datetime.fromtimestamp()]]</code>: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع <code>time.time()</code>. |
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 19:12، 5 يوليو 2018
يعيد التابع كائن 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 في توثيق بايثون الرسمي.