الفرق بين المراجعتين لصفحة: «Python/datetime/time/isoformat»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>time.isoformat()</code> في بايثون}}</noinclude> يعيد التابع سلسلة نصية تمثّل الوقت...' |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601. | يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601. | ||
==البنية العامة== | |||
== البنية العامة == | |||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
time.isoformat(timespec='auto') | time.isoformat(timespec='auto') | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>timespec</code>=== | ||
يحدّد المعامل الاختياري <code>timespec</code> عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي <code>'auto'</code>)، ويمكن للمكونات أن تكون واحدة ممّا يلي: | |||
=== timespec=== | *<code>'auto'</code>: مشابه للمكون <code>'second'</code> إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن <code>'microseconds'</code>. | ||
*<code>'hours'</code>: تضمين الساعة بهيئة رقمين <code>HH</code>. | |||
يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي: | *<code>'minutes'</code>: تضمين الساعة والدقيقة بالصيغة <code>HH:MM</code>. | ||
*<code>'seconds'</code>: تضمين الساعة والدقيقة والثانية بالصيغة <code>HH:MM:SS</code>. | |||
* 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'. | *<code>'milliseconds'</code>: تضمين الوقت كاملًا، مع اقتطاع قيم الثانية الكسرية إلى أجزاء من الثانية، بالصيغة <code>HH:MM:SS.sss</code>. | ||
* 'hours': تضمين الساعة بهيئة رقمين HH. | *<code>'microseconds'</code>: عرض الوقت كاملًا بالصيغة <code>HH:MM:SS.mmmmmm</code>. | ||
* 'minutes': تضمين الساعة والدقيقة بالصيغة HH:MM. | |||
* 'seconds': تضمين الساعة والدقيقة والثانية بالصيغة HH:MM:SS. | |||
* 'milliseconds': تضمين الوقت كاملًا، مع اقتطاع قيم الثانية الكسرية إلى أجزاء من الثانية، بالصيغة HH:MM:SS.sss. | |||
* 'microseconds': عرض الوقت كاملًا بالصيغة HH:MM:SS.mmmmmm. | |||
'''ملاحظة''': تُقتطع مكوّنات الوقت المستثناة ولا تقرّب. | '''ملاحظة''': تُقتطع مكوّنات الوقت المستثناة ولا تقرّب. | ||
'''ملاحظة''': أضيف المعامل <code>timespec</code> في الإصدار 3.6 من اللغة. | |||
== القيمة المعادة == | تطلق اللغة الخطأ <code>ValueError</code> في حال استخدام معامل <code>timesepc</code> غير صالح. | ||
==القيمة المعادة== | |||
يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601 وهي <code>HH:MM:SS.mmmmmm</code>، أو الصيغة <code>HH:MM:SS</code> إن كانت قيمة أجزاء الثانية مساوية للصفر. | |||
إن لم يعد التابع <code>utcoffset()</code> القيمة <code>None</code>، تضاف إلى السلسلة النصية سلسلة أخرى ذات 6 أحرف، تعرض مقدار الإزاحة (مع إشارة (<code>-</code>) أو (<code>+</code>) للدلالة على الزيادة أو النقصان) عن التوقيت العالمي المنسّق بالساعات والدقائق <code>HH:MM:SS.mmmmmm+HH:MM</code>. وتأخذ هذه السلسلة الصيغة <code>HH:MM:SS+HH:MM</code> إن كانت قيمة <code>self.microsecond</code> مساوية للصفر. | |||
==أمثلة== | |||
== أمثلة == | يبين المثال التالي آلية عمل التابع:<syntaxhighlight lang="python3"> | ||
يبين المثال التالي آلية عمل التابع: | |||
<syntaxhighlight lang="python3"> | |||
>>> from datetime import time | >>> from datetime import time | ||
>>> time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes') | >>> time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes') | ||
| سطر 44: | سطر 35: | ||
'12:34:56' | '12:34:56' | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | |||
== انظر أيضًا == | ==مصادر== | ||
* [https://docs.python.org/3/library/datetime.html#datetime.time.isoformat قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | |||
== مصادر == | |||
[https://docs.python.org/3/library/datetime.html#datetime.time.isoformat قسم time Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | |||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
المراجعة الحالية بتاريخ 20:21، 2 يوليو 2018
يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار 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'