التابع date.fromordinal()‎ في بايثون

من موسوعة حسوب
< Python‏ | datetime‏ | date


يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 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()‎.

مصادر