عرض مصدر Python/datetime/time/replace

<noinclude>{{DISPLAYTITLE:التابع <code>time.replace()‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
‎time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)
</syntaxhighlight>

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

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

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

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

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

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

== أمثلة ==

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

<syntaxhighlight lang="python3">
‎>>> 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)
</syntaxhighlight>

== انظر أيضًا ==

== مصادر ==
[https://docs.python.org/3/library/datetime.html#datetime.time.replace قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]