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

من موسوعة حسوب
< Python‏ | datetime‏ | time
لا ملخص تعديل
لا ملخص تعديل
 
سطر 10: سطر 10:


== المعاملات ==
== المعاملات ==
يأخذ التابع خمسة معاملات مفتاحية، هي hour و minute و second و microsecond (الساعة والدقيقة والثانية وجزء الثانية).
يأخذ التابع خمسة معاملات مفتاحية، هي <code>hour</code> و <code>minute</code> و <code>second</code> و <code>microsecond</code> (الساعة والدقيقة والثانية وجزء الثانية).


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


يمكن تعيين قيمة None المعامل tzinfo لإنشاء كائن وقت بسيط من كائن وقت واعي، دون الحاجة إلى تحويل بيانات الوقت.
يمكن تعيين قيمة <code>None</code> للمعامل <code>tzinfo</code> لإنشاء كائن وقت بسيط باستخدام كائن وقت واعي، دون الحاجة إلى تحويل بيانات الوقت.


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


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

المراجعة الحالية بتاريخ 19:26، 2 يوليو 2018


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

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

time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)

المعاملات

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

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

يمكن تعيين قيمة None للمعامل tzinfo لإنشاء كائن وقت بسيط باستخدام كائن وقت واعي، دون الحاجة إلى تحويل بيانات الوقت.

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

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

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

أمثلة

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

>>> from datetime import time
>>> t = time(hour=12, minute=34, second=56, microsecond=0)
>>> t.replace(hour=15, minute=22)
datetime.time(15, 22, 56)

انظر أيضًا

مصادر

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