الفرق بين المراجعتين ل"Python/datetime/date/fromisoformat"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()</code> في بايثون}}</noinclude> يعيد التابع التاريخ الموافق لسلسل...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()</code> في بايثون}}</noinclude> | ||
− | يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat(). | + | يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع <code>[[Python/datetime/date/isoformat|date.isoformat()]]</code>. |
== البنية العامة == | == البنية العامة == | ||
سطر 12: | سطر 12: | ||
=== <code>date_string</code> === | === <code>date_string</code> === | ||
− | سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن | + | سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن <code>date</code>، وتتبع السلسلة النصية الصيغة <code>YYYY-MM-DD</code>. |
== القيمة المعادة == | == القيمة المعادة == | ||
− | كائن date يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string. | + | كائن <code>date</code> يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية <code>date_string</code>. |
− | '''تنبيه''': لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat(). | + | '''تنبيه''': لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع <code>[[Python/datetime/date/isoformat|date.isoformat()]]</code>. |
'''ملاحظة''': هذا التابع جديد في الإصدار 3.7 من اللغة. | '''ملاحظة''': هذا التابع جديد في الإصدار 3.7 من اللغة. |
المراجعة الحالية بتاريخ 07:54، 5 يوليو 2018
يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat()
.
البنية العامة
date.fromisoformat(date_string)
المعاملات
date_string
سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن date
، وتتبع السلسلة النصية الصيغة YYYY-MM-DD
.
القيمة المعادة
كائن date
يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string
.
تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat()
.
ملاحظة: هذا التابع جديد في الإصدار 3.7 من اللغة.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> from datetime import date
>>> t = date.fromisoformat("2018-07-05")
>>> print(t)
2018-07-05
>>> t
datetime.date(2018, 7, 5)
انظر أيضًا
- التابع
date.today()
: يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. - التابع
date.fromtimestamp()
: يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغةPOSIX
كالذي يعيده التابعtime.time()
.
مصادر
قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.