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

يعيد التابع كائن 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.fromisoformat()‎:

مصادر

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