الفرق بين المراجعتين لصفحة: «Python/datetime/time/replace»
لا ملخص تعديل |
لا ملخص تعديل |
||
سطر 10: | سطر 10: | ||
== المعاملات == | == المعاملات == | ||
يأخذ التابع خمسة معاملات مفتاحية، هي hour و minute و second و microsecond (الساعة والدقيقة والثانية وجزء الثانية). | يأخذ التابع خمسة معاملات مفتاحية، هي <code>hour</code> و <code>minute</code> و <code>second</code> و <code>microsecond</code> (الساعة والدقيقة والثانية وجزء الثانية). | ||
تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن الوقت. | تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن الوقت. | ||
يمكن تعيين قيمة None | يمكن تعيين قيمة <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 في توثيق بايثون الرسمي.