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

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

يعيد التابع كائن <code>datetime</code> الناتج عن دمج كائني <code>date</code> و <code>time</code> بعضهما ببعض.

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

<syntaxhighlight lang="python3">
‎classmethod datetime.combine(date, time, tzinfo=self.tzinfo)
</syntaxhighlight>

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

=== <code>date</code> ===

كائن <code>date</code> المراد استخدامه لإنشاء الكائن الجديد. 

=== <code>time</code> ===

كائن <code>time</code> المراد استخدامه لإنشاء الكائن الجديد. 

=== <code>tzinfo</code> ===
معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة.

تستخدم قيمة المعامل <code>tzinfo</code> في حال توفّرها كقيمة لخاصية <code>tzinfo</code> في الكائن الجديد، أما في حال عدم توفّرها فتُستخدم خاصية <code>tzinfo</code> التابعة لمعامل <code>time</code>.

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

يعيد التابع كائن <code>datetime</code> تكون مكوّنات التاريخ فيه مساوية لكائنات <code>date</code> المعطاة، وتكون مكوّنات الوقت فيه مساوية لكائنات <code>time</code> المعطاة.

لو فرضنا أن <code>d</code> هو كائن <code>datetime</code>، فإنّ <code>d == datetime.combine(d.date(), d.time(), d.tzinfo)‎</code>. 

إذا كان التاريخ عبارة عن كائن <code>datetime</code>، فإنّ اللغة تتجاهل مكوّنات الوقت الخاصّة به إضافة إلى خصائص <code>tzinfo</code>.

'''ملاحظة''': أضيف المعامل <code>tzinfo</code> في الإصدار 3.6 من اللغة.

== أمثلة ==

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

<syntaxhighlight lang="python3">
‎>>> from datetime import date, time, datetime
>>> d = date(2018, 7, 5)
>>> t = time(22, 47, 12)
>>> dt = datetime.combine(d, t)
>>> print(dt)
2018-07-05 22:47:12

</syntaxhighlight>

== انظر أيضًا ==

* التابع <code>[[Python/datetime/datetime/fromordinal|datetime.fromordinal()]]</code>‎: يعيد التابع كائن <code>datetime</code> الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية.
* التابع <code>[[Python/datetime/datetime/fromisoformat|datetime.fromisoformat()]]</code>‎: يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع <code>[[Python/datetime/date/isoformat|datetime.isoformat()]]</code>‎.
* التابع <code>[[Python/datetime/datetime/fromtimestamp|datetime.fromisoformat()]]</code>‎: يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع <code>time.time()‎</code>.

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

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