التابع datetime.strptime()‎ في بايثون

ينسّق التابع كائن datetime الموافق لسلسلة التاريخ النصية المعطاة، باستخدام سلسلة التنسيق النصية المعطاة.

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

datetime.strptime(date_string, format)

المعاملات

date_string

سلسلة التاريخ النصية التي يستخدمها التابع لإنشاء كائن datetime الموافق.

format

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

راجع قسم (التابعان strftime()‎ و strptime()‎ ).

تطلق اللغة الخطأ ValueError إن لم يكن التابع time.strptime()‎ قادرًا على تفسير سلسلة التاريخ النصية أو سلسلة التنسيق النصية، أو إن أعاد التابع قيمة ليست من نوع صفّ وقتي time tuple.

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

يعيد التابع كائن datetime يكون التاريخ والوقت فيها منسّقين بحسب سلسلة التنسيق النصية الممرّرة إلى التابع.

عمل هذا التابع مكافئ للتعبير datetime(*(time.strptime(date_string, format)[0:6]))‎

أمثلة

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

>>> from datetime import datetime
>>> dt = datetime.strptime("05/07/18 23:03", "%d/%m/%y %H:%M")
>>> dt
datetime.datetime(2018, 7, 5, 23, 3)

انظر أيضًا

• التابعان strftime()‎ و strptime()‎ .
• التابع datetime.__format__()‎: يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن datetime باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع str.format()‎.

مصادر

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