عرض مصدر Python/datetime/datetime/strptime

<noinclude>{{DISPLAYTITLE:التابع <code>datetime.strptime()‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
datetime.strptime(date_string, format)
</syntaxhighlight>

== المعاملات ==

=== <code>date_string</code> ===

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

=== <code>format</code> ===

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

راجع قسم ([[Python/datetime#.D8.A7.D9.84.D8.AA.D8.A7.D8.A8.D8.B9.D8.A7.D9.86 strftime.28.29.E2.80.8E .D9.88 strptime.28.29.E2.80.8E|التابعان <code>strftime()‎</code> و <code>strptime()</code>‎]] ).

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

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

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

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

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> 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)

</syntaxhighlight>

== انظر أيضًا ==
* [[Python/datetime#.D8.A7.D9.84.D8.AA.D8.A7.D8.A8.D8.B9.D8.A7.D9.86 strftime.28.29.E2.80.8E .D9.88 strptime.28.29.E2.80.8E|التابعان <code>strftime()‎</code> و <code>strptime()</code>‎]] .
* التابع <code>[[Python/datetime/datetime/ format|datetime.__format__()‎]]</code>: يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن <code>datetime</code> باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع <code>[[Python/str/format|str.format()]]</code>‎.

== مصادر ==
[https://docs.python.org/3/library/datetime.html#datetime.datetime.strptime قسم date Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]