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

يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601.

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

‎time.isoformat(timespec='auto')

المعاملات

timespec

يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي:

• 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'.
• 'hours': تضمين الساعة بهيئة رقمين HH.
• 'minutes': تضمين الساعة والدقيقة بالصيغة HH:MM.
• 'seconds': تضمين الساعة والدقيقة والثانية بالصيغة HH:MM:SS.
• 'milliseconds': تضمين الوقت كاملًا، مع اقتطاع قيم الثانية الكسرية إلى أجزاء من الثانية، بالصيغة HH:MM:SS.sss.
• 'microseconds': عرض الوقت كاملًا بالصيغة HH:MM:SS.mmmmmm.

ملاحظة: تُقتطع مكوّنات الوقت المستثناة ولا تقرّب.

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

تطلق اللغة الخطأ ValueError في حال استخدام معامل timesepc غير صالح.

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

يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601 وهي HH:MM:SS.mmmmmm، أو الصيغة HH:MM:SS إن كانت قيمة أجزاء الثانية مساوية للصفر.

إن لم يعد التابع utcoffset()‎ القيمة None، تضاف إلى السلسلة النصية سلسلة أخرى ذات 6 أحرف، تعرض مقدار الإزاحة (مع إشارة (-) أو (+) للدلالة على الزيادة أو النقصان) عن التوقيت العالمي المنسّق بالساعات والدقائق HH:MM:SS.mmmmmm+HH:MM. وتأخذ هذه السلسلة الصيغة HH:MM:SS+HH:MM إن كانت قيمة self.microsecond مساوية للصفر.

أمثلة

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

‎>>> from datetime import time
>>> time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes')
'12:34'
>>> dt = time(hour=12, minute=34, second=56, microsecond=0)
>>> dt.isoformat(timespec='microseconds')
'12:34:56.000000'
>>> dt.isoformat(timespec='auto')
'12:34:56'

مصادر

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