التابع timezone.tzname()‎ في بايثون

يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف 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 في توثيق بايثون الرسمي.