الفرق بين المراجعتين لصفحة: «Python/datetime/timezone/tzname»
لا ملخص تعديل |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | ||
يعيد التابع القيمة الثابتة والتي | يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 41: | سطر 41: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع [[Python/datetime/timezone/utcoffset|<code>timezone.utcoffset()</code>]]: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. | * التابع [[Python/datetime/timezone/utcoffset|<code>timezone.utcoffset()</code>]]: يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
* التابع <code>[[Python/datetime/timezone/fromutc|timezone.fromutc()]]</code>: يعيد التابع قيمة كائن <code>datetime</code> مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 21:54، 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. - التابع
timezone.fromutc(): يعيد التابع قيمة كائنdatetimeمضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق.
مصادر
قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.