الفرق بين المراجعتين لصفحة: «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 في توثيق بايثون الرسمي.