الفرق بين المراجعتين لصفحة: «Python/datetime/datetime/combine»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> يعيد التابع كائن datetime الناتج عن دمج...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> | ||
يعيد التابع كائن datetime الناتج عن دمج كائني date و time بعضهما ببعض. | يعيد التابع كائن <code>datetime</code> الناتج عن دمج كائني <code>date</code> و <code>time</code> بعضهما ببعض. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 13: | سطر 13: | ||
=== <code>date</code> === | === <code>date</code> === | ||
كائن date المراد استخدامه لإنشاء الكائن الجديد. | كائن <code>date</code> المراد استخدامه لإنشاء الكائن الجديد. | ||
=== <code>time</code> === | === <code>time</code> === | ||
كائن time المراد استخدامه لإنشاء الكائن الجديد. | كائن <code>time</code> المراد استخدامه لإنشاء الكائن الجديد. | ||
=== <code>tzinfo</code> === | === <code>tzinfo</code> === | ||
معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة. | معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة. | ||
تستخدم قيمة المعامل tzinfo في حال توفّرها كقيمة لخاصية tzinfo في الكائن الجديد، أما في حال عدم توفّرها فتُستخدم خاصية tzinfo التابعة لمعامل time. | تستخدم قيمة المعامل <code>tzinfo</code> في حال توفّرها كقيمة لخاصية <code>tzinfo</code> في الكائن الجديد، أما في حال عدم توفّرها فتُستخدم خاصية <code>tzinfo</code> التابعة لمعامل <code>time</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع كائن datetime تكون مكوّنات التاريخ فيه مساوية لكائنات date المعطاة، وتكون مكوّنات الوقت فيه مساوية لكائنات time المعطاة. | يعيد التابع كائن <code>datetime</code> تكون مكوّنات التاريخ فيه مساوية لكائنات <code>date</code> المعطاة، وتكون مكوّنات الوقت فيه مساوية لكائنات <code>time</code> المعطاة. | ||
لو فرضنا أن d هو كائن | لو فرضنا أن <code>d</code> هو كائن <code>datetime</code>، فإنّ <code>d == datetime.combine(d.date(), d.time(), d.tzinfo)</code>. | ||
إذا كان التاريخ عبارة عن كائن | إذا كان التاريخ عبارة عن كائن <code>datetime</code>، فإنّ اللغة تتجاهل مكوّنات الوقت الخاصّة به إضافة إلى خصائص <code>tzinfo</code>. | ||
'''ملاحظة''': أضيف المعامل tzinfo في الإصدار 3.6 من اللغة. | '''ملاحظة''': أضيف المعامل <code>tzinfo</code> في الإصدار 3.6 من اللغة. | ||
== أمثلة == | == أمثلة == | ||
| سطر 50: | سطر 50: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع datetime.fromordinal(): | * التابع <code>[[Python/datetime/datetime/fromordinal|datetime.fromordinal()]]</code>: يعيد التابع كائن <code>datetime</code> الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد <code>1</code> موافقًا للتاريخ <code>1</code> كانون الثاني (يناير) سنة <code>1</code> ميلادية. | ||
* التابع datetime.fromisoformat(): | * التابع <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>. | |||
== مصادر == | == مصادر == | ||
مراجعة 19:52، 5 يوليو 2018
يعيد التابع كائن 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 في توثيق بايثون الرسمي.