الفرق بين المراجعتين لصفحة: «Python/datetime/datetime/strptime»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.strptime()</code> في بايثون}}</noinclude> ينسّق التابع كائن datetime الموافق لس...' |
لا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.strptime()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.strptime()</code> في بايثون}}</noinclude> | ||
ينسّق التابع كائن datetime الموافق لسلسلة التاريخ النصية المعطاة، باستخدام سلسلة التنسيق النصية المعطاة. | ينسّق التابع كائن <code>datetime</code> الموافق لسلسلة التاريخ النصية المعطاة، باستخدام سلسلة التنسيق النصية المعطاة. | ||
== البنية العامة == | == البنية العامة == | ||
سطر 13: | سطر 13: | ||
=== <code>date_string</code> === | === <code>date_string</code> === | ||
سلسلة التاريخ النصية التي يستخدمها التابع لإنشاء كائن datetime الموافق. | سلسلة التاريخ النصية التي يستخدمها التابع لإنشاء كائن <code>datetime</code> الموافق. | ||
=== <code>format</code> === | === <code>format</code> === | ||
سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق الوقت والتاريخ في كائن datetime المعاد. | سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق الوقت والتاريخ في كائن <code>datetime</code> المعاد. | ||
راجع قسم ([[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>]] ). | راجع قسم ([[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. | تطلق اللغة الخطأ <code>ValueError</code> إن لم يكن التابع <code>time.strptime()</code> قادرًا على تفسير سلسلة التاريخ النصية أو سلسلة التنسيق النصية، أو إن أعاد التابع قيمة ليست من نوع [[Python/tuples|صفّ]] وقتي time tuple. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع كائن datetime يكون التاريخ والوقت فيها منسّقين بحسب سلسلة التنسيق النصية الممرّرة إلى التابع. | يعيد التابع كائن <code>datetime</code> يكون التاريخ والوقت فيها منسّقين بحسب سلسلة التنسيق النصية الممرّرة إلى التابع. | ||
عمل هذا التابع مكافئ للتعبير <code>datetime(*(time.strptime(date_string, format)[0:6]))</code> | عمل هذا التابع مكافئ للتعبير <code>datetime(*(time.strptime(date_string, format)[0:6]))</code> | ||
== أمثلة == | == أمثلة == |
المراجعة الحالية بتاريخ 20:10، 5 يوليو 2018
ينسّق التابع كائن 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 في توثيق بايثون الرسمي.