الفرق بين المراجعتين لصفحة: «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)‎، فإنّ الاسم يكون "UTC"، وباستثناء ذلك يكون الاسم ‎'UTC±HH:MM'‎، حيث يمثّل الرمز ± اتجاه الإزاحة، والحرفان HH و MM هما عددان يأخذان القيمة offset.hours و offset.minutes على التوالي.
إن كان المعامل <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 في توثيق بايثون الرسمي.