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

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

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

‎classmethod datetime.combine(date, time, tzinfo=self.tzinfo)

المعاملات

date

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

time

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

tzinfo

معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة.

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

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

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

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

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

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

أمثلة

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

‎>>> 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

انظر أيضًا

• التابع datetime.fromordinal()‎: يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية.
• التابع datetime.fromisoformat()‎: يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat()‎.
• التابع datetime.fromisoformat()‎: يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time()‎.

مصادر

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