الفرق بين المراجعتين ل"Python/datetime/datetime/fromordinal"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.fromordinal()</code> في بايثون}}</noinclude> يعيد التابع التاريخ الموافق للع...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.fromordinal()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.fromordinal()</code> في بايثون}}</noinclude> | ||
| − | يعيد التابع التاريخ | + | يعيد التابع كائن <code>datetime</code> الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية. |
== البنية العامة == | == البنية العامة == | ||
| سطر 16: | سطر 16: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| − | يعيد التابع التاريخ | + | يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري. |
ن كانت قيمة المعامل <code>ordinal</code> المعطاة تقع خارج النطاق <code>1 <= ordinal <= date.max.toordinal()</code> فإنّ اللغة تطلق الخطأ <code>ValueError</code>. | ن كانت قيمة المعامل <code>ordinal</code> المعطاة تقع خارج النطاق <code>1 <= ordinal <= date.max.toordinal()</code> فإنّ اللغة تطلق الخطأ <code>ValueError</code>. | ||
| − | تأخذ الساعة والدقيقة والثانية وأجزاء الثانية في النتيجة القيمة | + | تأخذ الساعة والدقيقة والثانية وأجزاء الثانية في النتيجة القيمة <code>0</code>، ويأخذ <code>tzinfo</code> القيمة <code>None</code>. |
== أمثلة == | == أمثلة == | ||
| سطر 38: | سطر 38: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * التابع datetime.fromisoformat(): يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat(). | + | * التابع datetime.fromisoformat(): يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع <code>[[Python/datetime/datetime/isoformat|datetime.isoformat()]]</code>. |
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/datetime.html#datetime.datetime.fromordinal قسم date Object في صفحة Basic date and time types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/datetime.html#datetime.datetime.fromordinal قسم date Object في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
المراجعة الحالية بتاريخ 19:41، 5 يوليو 2018
يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية.
البنية العامة
datetime.fromordinal(ordinal)
المعاملات
ordinal
العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية.
القيمة المعادة
يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري.
ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق 1 <= ordinal <= date.max.toordinal() فإنّ اللغة تطلق الخطأ ValueError.
تأخذ الساعة والدقيقة والثانية وأجزاء الثانية في النتيجة القيمة 0، ويأخذ tzinfo القيمة None.
أمثلة
يبين المثال التالي طريقة استخدام هذا التابع:
>>> from datetime import datetime
>>> dt = datetime.fromordinal(740301) # اليوم ذو الرقم 740301 منذ التاريخ 01. 01. 0001
>>> dt
datetime.datetime(2027, 11, 16, 0, 0)
>>> print(dt)
2027-11-16 00:00:00
انظر أيضًا
- التابع datetime.fromisoformat(): يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع
datetime.isoformat().