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

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

يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن <code>datetime</code> باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع <code>[[Python/str/format|str.format()]]</code>‎.

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

<syntaxhighlight lang="python3">
‎datetime.__format__(format)
</syntaxhighlight>

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

=== <code>format</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>‎]] ).

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

يعيد التابع سلسلة نصية ذات تنسيق محدّد بواسطة موجّهات التنسيق الخاصة.

== أمثلة ==

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

<syntaxhighlight lang="python3">
‎>>> from datetime import datetime
>>> d = datetime(2018, 6, 27, 23, 16, 39)
>>> dt = datetime(2018, 6, 27, 23, 16, 39)
>>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'.format(dt, "day", "month", "time")
'The day is 27, the month is June, the time is 11:16PM.'

</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/ str|date.__str__()‎]]</code>: يتيح هذا التابع إعادة تمثيل للكائن <code>datetime</code> على هيئة سلسلة نصية قابلة للطباعة، باستخدام الدالة <code>[[Python/str#.D8.A7.D9.84.D8.AA.D8.AD.D9.88.D9.8A.D9.84 .D8.A5.D9.84.D9.89 .D8.B3.D9.84.D8.B3.D9.84.D8.A9 .D9.86.D8.B5.D9.8A.D8.A9|str()‎]]</code>.
== مصادر ==
[https://docs.python.org/3/library/datetime.html#datetime.datetime.__format__ قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]

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