الصنف date.fromisofromat()‎ في بايثون

من موسوعة حسوب
< Python‏ | datetime‏ | date
اذهب إلى التنقل اذهب إلى البحث


يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع 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 في توثيق بايثون الرسمي.