التابع 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'

مصادر

قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.