التابع datetime.fromordinal()
في بايثون
يعيد التابع كائن 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()
.