l25: datetime.time. completed

Saeid Darvish · Saeid Darvish · commit 71fa52c5b790 · 2021-04-11T20:43:42.000+04:30
diff --git a/lessons/l10.rst b/lessons/l10.rst
@@ -5,8 +5,8 @@
    :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, انواع شی, انواع داده, انواع شی در پایتون, انواع داده در پایتون,  پایتون
 
 
-درس ۱۰: فایل، ورودی و خروجی در پایتون
-========================================
+درس ۱۰: فایل، ورودی و خروجی (I/O) در پایتون
+======================================================
 
 .. figure:: /_static/pages/10-python-input-output-file.jpg
     :align: center
diff --git a/lessons/l25.rst b/lessons/l25.rst
@@ -256,7 +256,7 @@
 کلاس ``datetime.date``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-این کلاس [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#date-objects>`__] نمایش ایجاد یک شی تاریخ بر اساس گاه‌شماری میلادی (Gregorian calendar) در زبان برنامه‌نویسی پایتون می‌باشد. در ادامه این بخش به بررسی چگونگی ایجاد شی و اجزای آن خواهیم پرداخت.
+این کلاس [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#date-objects>`__] نمایش ایجاد یک شی تاریخ بر اساس گاه‌شماری میلادی (Gregorian calendar) در زبان برنامه‌نویسی پایتون می‌باشد. در واقع کاربرد این شی، نگهداری از اطلاعات مربوط به یک تاریخ مشخص خواهد بود. در ادامه این بخش به بررسی چگونگی ایجاد شی و اجزای آن خواهیم پرداخت.
 
 ایجاد شی تاریخ
 ------------------
@@ -516,7 +516,7 @@
 کلاس ``datetime.time``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-این کلاس [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#time-objects>`__] نمایش ایجاد یک شی ساعت مشخص از روز در زبان برنامه‌نویسی پایتون می‌باشد. در ادامه این بخش به بررسی چگونگی ایجاد شی و اجزای آن خواهیم پرداخت.
+این کلاس [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#time-objects>`__] نمایش ایجاد یک شی ساعت مشخص از شبانه‌روز در زبان برنامه‌نویسی پایتون می‌باشد. در واقع کاربرد این شی، نگهداری از اطلاعات مربوط به یک ساعت مشخص خواهد بود. در ادامه این بخش به بررسی چگونگی ایجاد شی و اجزای آن خواهیم پرداخت.
 
 ایجاد شی ساعت
 ------------------
@@ -710,7 +710,33 @@
     >>> t.isoformat('microseconds')
     '22:04:30.000300'
 
+* **متد** ``utcoffset`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#datetime.time.utcoffset>`__]: اگر پارامتر ``tzinfo`` برابر ``None`` باشد، مقدار ``None`` و در غیر این صورت مقدار ``self.tzinfo.utcoffset(None)`` را برمی‌گرداند.
 
+* **متد** ``tzname`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#datetime.time.tzname>`__]: اگر پارامتر ``tzinfo`` برابر ``None`` باشد، مقدار ``None`` و در غیر این صورت مقدار ``self.tzinfo.tzname(None)`` را برمی‌گرداند.
+
+::
+
+    >>> from datetime import timedelta, timezone, time
+
+    >>> tz = timezone(timedelta(hours=4, minutes=30), 'Asia/Tehran')
+    >>> t = time(hour=22, minute=4, second=30, tzinfo=tz)
+
+    >>> t.utcoffset()
+    datetime.timedelta(seconds=16200)
+
+    >>> t.tzname()
+    'Asia/Tehran'
+
+
+
+naive / aware
+----------------------------
+
+یک شی ``datetime.time`` (به عنوان مثال متغیر:‌ ``t``) از نوع aware خواهد بود اگر دو شرط زیر برای آن درست باشد:
+
+
+* مقدار پارامتر ``t.zinfo`` مخالف ``None`` باشد.
+* حاصل ``t.tzinfo.utcoffset(None)`` مخالف ``None`` باشد.
 
 
 
