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