الفرق بين المراجعتين لصفحة: «Python/datetime/date/fromtimestamp»

المراجعة الحالية بتاريخ 12:31، 25 يونيو 2018

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>date.fromtimestamp()‎</code> في بايثون}}</noinclude>
-يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎.
+يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة <code>POSIX</code> كالذي يعيده التابع <code>time.time()‎</code>.
 == البنية العامة ==
+<syntaxhighlight lang="python3">
+date.fromtimestamp(timestamp)
+</syntaxhighlight>
 == المعاملات ==
-=== <code>timestamp</code>
+=== <code>timestamp</code> ===
+الختم الزمني بصيغة <code>POSIX</code> والمراد معرفة التاريخ المحلي الموافق له. يعيد التابع <code>time.time()‎</code> ختمًا زمنيًا بصيغة <code>POSIX</code>.
-الختم الزمني بصيغة POSIX والمراد معرفة التاريخ المحلي الموافق له. يعيد التابع time.time()‎ ختمًا زمنيًا بصيغة POSIX.
+== القيمة المعادة ==
-== القيمة المعادة ==
+إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>localtime()</code>‎ في منصّة C، فإنّ التابع يطلق الخطأ <code>[[Python/built-in exceptions#OverflowError|OverflowError]]</code>، وإن حدث خطأ في تنفيذ الدالة <code>localtime()</code>‎ فإنّ التابع يطلق الخطأ [[Python/built-in exceptions|<code>OSError</code>]].
-إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة localtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverFlowError، وإن حدث خطأ في تنفيذ الدالة localtime()‎ فإنّ التابع يطلق الخطأ OSError.
+من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات <code>1970</code> إلى <code>2038</code>.
-من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038.
+من الجدير بالذكر أنّ التابع <code>fromtimestamp()‎</code> يتجاهل الثواني الكبسية التي تستخدمهاالأنظمة التي لا تدعم صيغة <code>POSIX</code> في تمثيل الختم الزمني.
-من الجدير بالذكر أنّ التابع fromtimestamp()‎ يتجاهل الثواني الكبسية التي تستخدمهاالأنظمة التي لا تدعم صيغة POSIX في تمثيل الختم الزمني.
+'''ملاحظة''': في الإصدار 3.3، تطلق اللغة الخطأ <code>[[Python/built-in exceptions#OverflowError|OverflowError]]</code> بدلًا من <code>[[Python/built-in exceptions#ValueError|ValueError]]</code> عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>localtime()‎</code> في منصّة C.
-'''ملاحظة''': في الإصدار 3.3، تطلق اللغة الخطأ OverflowError بدلًا من ValueError عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة localtime()‎ في منصّة C.
+وتطلق اللغة الخطأ [[Python/built-in exceptions|<code>OSError</code>]] بدلًا من <code>[[Python/built-in exceptions#ValueError|ValueError]]</code> عند حدوث خطأ في تنفيذ الدالة <code>localtime()</code>‎.
-وتطلق اللغة الخطأ OSError بدلًا من ValueError عند حدوث خطأ في تنفيذ الدالة localtime()‎.
 == أمثلة ==
@@ سطر 37: / سطر 40: @@
 == انظر أيضًا ==
+* التابع <code>[[Python/datetime/date/today|date.today()‎]]</code> : يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية.
+* التابع <code>[[Python/datetime/date/fromordinal|date.fromordinal()]]‎</code>: يعيد هذا التابع التاريخ بحسب العدد الترتيبي المعطى والتابع للتقويم الكريكوري التنبؤي.
 == مصادر ==
+* [https://docs.python.org/3/library/datetime.html#datetime.date.fromtimestamp قسم date Object في صفحة Basic date and time types في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
 [[تصنيف:Python Modules]]
 [[تصنيف:Python Methods]]