الفرق بين المراجعتين لصفحة: «Python/datetime/timezone/tzname»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> يعيد التابع القيمة الثابتة والتي ي...' |
لا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | ||
يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone. | يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
== البنية العامة == | == البنية العامة == | ||
سطر 15: | سطر 15: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone. | يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
في حال عدم تحديد قيمة للمعامل name في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع tzname(dt) يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: | في حال عدم تحديد قيمة للمعامل <code>name</code> في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع <code>tzname(dt)</code> يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: | ||
إن كان المعامل offset يحمل القيمة timedelta(0) | إن كان المعامل <code>offset</code> يحمل القيمة <code>timedelta(0)</code>، فإنّ الاسم يكون <code>"UTC"</code>، وباستثناء ذلك يكون الاسم <code>'UTC±HH:MM'</code>، حيث يمثّل الرمز ± اتجاه الإزاحة، والحرفان <code>HH</code> و <code>MM</code> هما عددان يأخذان القيمة <code>offset.hours</code> و <code>offset.minutes</code> على التوالي. | ||
'''ملاحظة''': في الإصدار 3.6 من بايثون أصبح الاسم المولّد من offset=timedelta(0) هو 'UTC' و ليس 'UTC+00:00'. | '''ملاحظة''': في الإصدار 3.6 من بايثون أصبح الاسم المولّد من <code>offset=timedelta(0)</code> هو <code>'UTC'</code> و ليس <code>'UTC+00:00'</code>. | ||
== أمثلة == | == أمثلة == | ||
سطر 40: | سطر 40: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع [[Python/datetime/timezone/utcoffset|<code>timezone.utcoffset()</code>]]: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. | |||
== مصادر == | == مصادر == |
مراجعة 21:43، 10 يوليو 2018
يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone
.
البنية العامة
timezone.tzname(dt)
المعاملات
dt
كائن datetime
المراد معرفة اسم المنطقة الزمنية الخاصة به.
القيمة المعادة
يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone
.
في حال عدم تحديد قيمة للمعامل name
في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع tzname(dt)
يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية:
إن كان المعامل offset
يحمل القيمة timedelta(0)
، فإنّ الاسم يكون "UTC"
، وباستثناء ذلك يكون الاسم 'UTC±HH:MM'
، حيث يمثّل الرمز ± اتجاه الإزاحة، والحرفان HH
و MM
هما عددان يأخذان القيمة offset.hours
و offset.minutes
على التوالي.
ملاحظة: في الإصدار 3.6 من بايثون أصبح الاسم المولّد من offset=timedelta(0)
هو 'UTC'
و ليس 'UTC+00:00'
.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> from datetime import datetime, timedelta, timezone
>>> AST = timezone(timedelta(hours=3), name="Arabia Standard Time")
>>> dt = datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST)
>>> AST.tzname(dt)
'Arabia Standard Time'
>>> AST = timezone(timedelta(hours = 3))
>>> dt = datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST)
>>> AST.tzname(dt)
'UTC+03:00'
انظر أيضًا
- التابع
timezone.utcoffset()
: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنفtimezone
.
مصادر
قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.