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

من موسوعة حسوب
< Python‏ | datetime‏ | time


يحدّد التابع اسم المنطقة الزمنية لكائن الوقت.

البنية العامة

time.tzname()

القيمة المعادة

إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.tzname(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد.

ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق.

أمثلة

يبين المثال التالي آلية عمل التابع:

>>> from datetime import time, tzinfo, timedelta
>>> class GMT1(tzinfo):
...     def tzname(self, dt):
...             return "Europe/Prague"
... 
>>> t = time(12, 10, 30, tzinfo=GMT1())
>>> t
datetime.time(12, 10, 30, tzinfo=<__main__.GMT1 object at 0x7f6f3f13afd0>)
>>> gmt = GMT1()
>>> t.tzname()
'Europe/Prague'

انظر أيضًا

  • التابع time.dst()‎: التحكم في نظام التوقيت الصيفي.
  • التابع time.utcoffset()‎: يحدّد التابع مقدار الإزاحة عن التوقيت العالمي المنسّق.

مصادر

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