الفرق بين المراجعتين لصفحة: «Python/datetime/datetime/fromtimestamp»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> يعيد التابع التاريخ والوقت المحلّي...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | ||
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time(). | يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع <code>time.time()</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 11: | سطر 11: | ||
=== <code>timestamp</code> === | === <code>timestamp</code> === | ||
سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. | سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن <code>datetime</code>. | ||
=== <code>tz</code> == | ===<code>tz</code> === | ||
صنف فرعي من الصنف | صنف فرعي من الصنف <code>tzinfo</code>، يحدّد المنطقة الزمنية. | ||
يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له. | يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن <code>datetime</code> المعاد كائنًا بسيطًا في حال إعطاء القيمة <code>None</code> إلى المعامل الاختياري <code>tz</code> أو في حال عدم تحديد أيّ قيمة له. | ||
إن لم يأخذ المعامل tz القيمة | إن لم يأخذ المعامل <code>tz</code> القيمة <code>None</code>، فيجب أن تكون القيمة نسخة من صنف <code>tzinfo</code> فرعي، ويحوّل الختم الزمني إلى المنطقة الزمنية المعطاة. وفي هذه الحالة تكون النتيجة مكافئة للتعبير <code>totz.fromutc(datetime.utcfromtimestamp(timestamp).replace(tzinfo=tz))</code> | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time(). | يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع <code>time.time()</code>. | ||
يمكن للتابع fromtimestamp() أن يطلق الخطأ OverflowError إن كان الختم الزمني خارجًا عن نطاق القيم المدعوم بواسطة الدالة localtime() أو gmtime() في لغة C، ويطلق الخطأ OSError عند حدوث خطأ في تنفيذ الدالتين السابقتين. | يمكن للتابع <code>fromtimestamp()</code> أن يطلق الخطأ <code>OverflowError</code> إن كان الختم الزمني خارجًا عن نطاق القيم المدعوم بواسطة الدالة <code>localtime()</code> أو <code>gmtime()</code> في لغة C، ويطلق الخطأ <code>OSError</code> عند حدوث خطأ في تنفيذ الدالتين السابقتين. | ||
من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038. | من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 إلى 2038. | ||
من الجدير بالذكر أنّ التابع fromtimestamp() يتجاهل الثواني | من الجدير بالذكر أنّ التابع <code>fromtimestamp()</code> يتجاهل الثواني الكبيسة التي تستخدمها الأنظمة التي لا تدعم صيغة POSIX في تمثيل الختم الزمني، وهكذا يمكن أن يكون هناك ختمان زمنيان يختلفان عن بعضهما البعض بثانية واحدة وينتج عنهما كائنا <code>datetime</code> متطابقين. | ||
'''ملاحظة:''' في الإصدار 3.3، تطلق اللغة الخطأ <code>OverflowError</code> بدلًا من <code>ValueError</code> عندما يكون الختم الزمني خارج نطاق القيم التي تدعمها الدالة <code>localtime()</code> أو <code>gmtime()</code> في منصّة C. | |||
وتطلق اللغة الخطأ <code>OSError</code> بدلًا من <code>ValueError</code> عند حدوث خطأ في تنفيذ الدالة <code>localtime()</code> أو <code>gmtime()</code>. | |||
'''ملاحظة''': قد يعيد التابع <code>fromtimestamp()</code> نسخًا تكون قيمة المعامل <code>fold</code> فيها <code>1</code>. | |||
== أمثلة == | == أمثلة == | ||
| سطر 35: | سطر 41: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| >>> 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 | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
التابع <code>[[Python/datetime/datetime/utcfromtimestamp|datetime.utcfromtimestamp()]]</code>: يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني المعطى. | |||
== مصادر == | == مصادر == | ||
[https://docs.python.org/3/library/datetime.html#datetime.datetime. قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | [https://docs.python.org/3/library/datetime.html#datetime.datetime.fromtimestamp قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
مراجعة 18:55، 5 يوليو 2018
يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم 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 في توثيق بايثون الرسمي.