التابع time.replace()‎ في بايثون

من موسوعة حسوب
< Python‏ | datetime‏ | time


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

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

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 في توثيق بايثون الرسمي.