التابع 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()‎.

مصادر