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

يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat()‎.

البنية العامة

‎datetime.fromisoformat(date_string)

المعاملات

date_string

سلسلة نصية تتضمّن التاريخ والوقت المطلوب تحويلهما إلى كائن datetime، وتتبع السلسلة النصية الصيغة:

‎DD[*HH[:MM[:SS[.mmm[mmm]]]][+HH:MM[:SS[.ffffff]]]]‎

ويمكن للرمز * أن يطابق أيّ حرف مفرد.

القيمة المعادة

كائن datetime يكون التاريخ والوقت فيه موافقين للتاريخ والوقت المعطيين في السلسلة النصية date_string.

تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع datetime.isoformat()‎.

ملاحظة: هذا التابع جديد في الإصدار 3.7 من اللغة.

أمثلة

يبين المثال التالي آلية عمل التابع:

datetime.date(2018, 7, 5)
>>> from datetime import datetime
>>> dt = datetime.fromisoformat("2018-07-05 11:12:44")
>>> dt
datetime.datetime(2018, 7, 5, 11, 12, 44)
>>> print(dt)
2018-07-05 11:12:44

انظر أيضًا

• التابع datetime.today()‎ : يعيد التابع التاريخ والوقت الحاليين ضمن الإعدادات المحلية.
• التابع datetime.fromtimestamp()‎: يعيد هذا التابع التاريخ والوقت المحلّيين والموافقين للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎.

مصادر

قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.