الفرق بين المراجعتين لصفحة: «Python/datetime/timezone/tzname»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> يعيد التابع القيمة الثابتة والتي ي...' |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>timezone.tzname()</code> في بايثون}}</noinclude> | ||
يعيد التابع القيمة الثابتة والتي | يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 15: | سطر 15: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone. | يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف <code>timezone</code>. | ||
في حال عدم تحديد قيمة للمعامل name في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع tzname(dt) يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: | في حال عدم تحديد قيمة للمعامل <code>name</code> في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع <code>tzname(dt)</code> يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: | ||
إن كان المعامل offset يحمل القيمة timedelta(0) | إن كان المعامل <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>. | |||
* التابع <code>[[Python/datetime/timezone/fromutc|timezone.fromutc()]]</code>: يعيد التابع قيمة كائن <code>datetime</code> مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق. | |||
== مصادر == | == مصادر == | ||
[https://docs.python.org/3/library/datetime.html#datetime. | [https://docs.python.org/3/library/datetime.html#datetime.timezone.tzname قسم timezone Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
المراجعة الحالية بتاريخ 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 في توثيق بايثون الرسمي.