التابع 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'