التابع date.fromordinal()
في بايثون
يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1
موافقًا للتاريخ 1
كانون الثاني (يناير) سنة 1
ميلادية.
البنية العامة
date.fromordinal(ordinal)
المعاملات
ordinal
العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1
موافقًا للتاريخ 1
كانون الثاني (يناير) سنة 1
ميلادية.
القيمة المعادة
يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري.
ن كانت قيمة المعامل ordinal
المعطاة تقع خارج النطاق 1 <= ordinal <= date.max.toordinal()
فإنّ اللغة تطلق الخطأ ValueError
.
لو فرضنا أن d
يمثل تاريخًا معيّنًا، فإنّ date.fromordinal(d.toordinal()) == d
.
أمثلة
يبين المثال التالي طريقة استخدام هذا التابع:
>>> from datetime import date
>>> d = date.fromordinal(730920) # اليوم ذو الرقم 730920 بعد التاريخ 1. 1. 0001
>>> d
datetime.date(2002, 3, 11)
انظر أيضًا
- التابع
date.today()
: يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. - التابع
date.fromtimestamp()
: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغةPOSIX
كالذي يعيده التابعtime.time()
. - التابع
date.fromisoformat()
: يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat().