الفرق بين المراجعتين لصفحة: «Python/datetime/date/fromordinal»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>date.fromordinal()</code> في بايثون}}</noinclude> يعيد التابع التاريخ الموافق للعدد...' |
ط ←مصادر |
||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>date.fromordinal()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>date.fromordinal()</code> في بايثون}}</noinclude> | ||
يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. | يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 12: | سطر 12: | ||
=== <code>ordinal</code> === | === <code>ordinal</code> === | ||
العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. | العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي | يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري. | ||
ن كانت قيمة المعامل <code>ordinal</code> المعطاة تقع خارج النطاق <code>1 <= ordinal <= date.max.toordinal()</code> فإنّ اللغة تطلق الخطأ <code>ValueError</code>. | |||
لو فرضنا أن d يمثل تاريخًا معيّنًا، فإنّ date.fromordinal(d.toordinal()) == d. | |||
لو فرضنا أن <code>d</code> يمثل تاريخًا معيّنًا، فإنّ <code>date.fromordinal(d.toordinal()) == d</code>. | |||
== أمثلة == | == أمثلة == | ||
| سطر 27: | سطر 28: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
>>> from datetime import date | >>> from datetime import date | ||
>>> d = date.fromordinal(730920) # | >>> d = date.fromordinal(730920) # اليوم ذو الرقم 730920 بعد التاريخ 1. 1. 0001 | ||
>>> d | >>> d | ||
datetime.date(2002, 3, 11) | datetime.date(2002, 3, 11) | ||
| سطر 35: | سطر 36: | ||
* التابع <code>[[Python/datetime/date/today|date.today()]]</code> : يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. | * التابع <code>[[Python/datetime/date/today|date.today()]]</code> : يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. | ||
* التابع <code>[[Python/datetime/date/fromtimestamp|date.fromtimestamp()]]</code>: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة <code>POSIX</code> كالذي يعيده التابع <code>time.time()</code>. | * التابع <code>[[Python/datetime/date/fromtimestamp|date.fromtimestamp()]]</code>: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة <code>POSIX</code> كالذي يعيده التابع <code>time.time()</code>. | ||
* التابع <code>[[Python/datetime/date/fromisoformat|date.fromisoformat()]]</code>: يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat(). | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/datetime.html#datetime.date. | * [https://docs.python.org/3/library/datetime.html#datetime.date.fromordinal قسم date Object في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
المراجعة الحالية بتاريخ 19:17، 5 يوليو 2018
يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 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().