عرض مصدر Python/datetime/datetime/fromordinal

<noinclude>{{DISPLAYTITLE:التابع <code>datetime.fromordinal()‎</code> في بايثون}}</noinclude>

يعيد التابع كائن <code>datetime</code> الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية.

== البنية العامة ==
<syntaxhighlight lang="python3">
datetime.fromordinal(ordinal)
</syntaxhighlight>

== المعاملات ==

=== <code>ordinal</code> ===

العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية.

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

يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري.

ن كانت قيمة المعامل <code>ordinal</code> المعطاة تقع خارج النطاق <code>‎1 <= ordinal <= date.max.toordinal()</code>‎ فإنّ اللغة تطلق الخطأ <code>ValueError</code>.

تأخذ الساعة والدقيقة والثانية وأجزاء الثانية في النتيجة القيمة <code>0</code>، ويأخذ <code>tzinfo</code> القيمة <code>None</code>.

== أمثلة ==

يبين المثال التالي طريقة استخدام هذا التابع:

<syntaxhighlight lang="python3">
>>> 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

</syntaxhighlight>

== انظر أيضًا ==

* التابع 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 في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]