الفرق بين المراجعتين لصفحة: «Python/datetime/datetime/replace»

من موسوعة حسوب
طلا ملخص تعديل
طلا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.datetime.replace()‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>datetime.datetime.replace()‎</code> في بايثون}}</noinclude>


يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن datetime.
يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن <code>datetime</code>.


== البنية العامة ==
== البنية العامة ==
سطر 14: سطر 14:
إضافة إلى المعاملين <code>tzinfo</code> و <code>fold</code>.
إضافة إلى المعاملين <code>tzinfo</code> و <code>fold</code>.


تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن datetime.
تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن <code>datetime</code>.


تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في كائن datetime.
تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في كائن <code>datetime</code>.


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


يعيد التابع كائن datetime بعد إجراء عملية الاستبدال المحدّدة بواسطة المعاملات.
يعيد التابع كائن <code>datetime</code> بعد إجراء عملية الاستبدال المحدّدة بواسطة المعاملات.


== أمثلة ==
== أمثلة ==

المراجعة الحالية بتاريخ 21:40، 7 يوليو 2018


يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن datetime.

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

datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)

المعاملات

يأخذ التابع مجموعة من المعاملات المفتاحية هي year و month و day و hour و minute و second و microsecond (السنة والشهر واليوم والساعة والدقيقة والثانية وأجزاء الثانية).

إضافة إلى المعاملين tzinfo و fold.

تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن datetime.

تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في كائن datetime.

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

يعيد التابع كائن datetime بعد إجراء عملية الاستبدال المحدّدة بواسطة المعاملات.

أمثلة

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

>>> from datetime import datetime
>>> dt = datetime(2018, 7, 8, 0, 37, 44)
>>> print(dt)
2018-07-08 00:37:44
>>> c = dt.replace(year=2019, hour=14)
>>> print(c)
2019-07-08 14:37:44

مصادر

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