updating#00126

Author: Saeid Darvish

index.rst

@@ -20,7 +20,7 @@
  jgs`-.-` '.____.' `.____.'
 
 
-این کتاب تلاشی است برای آموزش زبان برنامه‌نویسی پایتون (Python) بر پایه‌ پیاده‌سازی استاندارد آن (CPython)، به شکلی کامل و ساده که بتواند هر دو شاخه از پایتون (نسخه‌های 3x و 2x) را البته با محوریت نسخه 3x پوشش دهد و همچنین برای افرادی که تاکنون سابقه‌ برنامه‌نویسی نداشته‌اند نیز کاربردی و مفید باشد. یادگیری پایتون نیازی به پیش‌زمینه برنامه‌نویسی ندارد و تنها پیش‌نیاز آن علاقه خوانندگان به فن برنامه‌نویسی است. 
+این کتاب تلاشی است برای آموزش زبان برنامه‌نویسی پایتون (Python) بر پایه‌ پیاده‌سازی استاندارد آن (CPython)، به شکلی کامل و ساده که بتواند هر دو شاخه از پایتون (نسخه‌های 3x و 2x) را البته با محوریت نسخه 3x (به خصوص از درس هفدهم به بعد) پوشش دهد و همچنین برای افرادی که تاکنون سابقه‌ برنامه‌نویسی نداشته‌اند نیز کاربردی و مفید باشد. یادگیری پایتون نیازی به پیش‌زمینه برنامه‌نویسی ندارد و تنها پیش‌نیاز آن علاقه خوانندگان به فن برنامه‌نویسی است. 
 
 .. toctree::
 :maxdepth:6
@@ -58,22 +58,21 @@
 
 |
 
-.. note::
- **این کتاب در حال توسعه می‌باشد...(سطح متوسط)**
+----
 
-**شروع:** فروردین ۱۳۹۴ **و** **آخرین بروزرسانی:** فروردین ۱۴۰۰ [`گزارش توسعه <log.html>`__]
+**شروع:** فروردین ۱۳۹۴ **و** **آخرین بروزرسانی:** فروردین ۱۴۰۰ [`گزارش توسعه <log.html>`__]
 
-.. note::
+----
 
-**برای محتوای این کتاب، چهار سطح آموزشی در نظر گرفته شده است:**
+**برای محتوای این کتاب، چهار سطح آموزشی در نظر گرفته شده است:**
 
-* **سطح پایه:** دروس ۱ تا ۵، معرفی پایتون و کسب مهارت لازم برای شروع کار با پایتون
+* **سطح پایه:** دروس ۱ تا ۵، معرفی پایتون و کسب مهارت لازم برای شروع کار با پایتون
 
-* **سطح مقدماتی:** دروس ۶ تا ۱۱، آشنایی با اجزا و ساختارهای ابتدایی در پایتون
+* **سطح مقدماتی:** دروس ۶ تا ۱۱، آشنایی با اجزا و ساختارهای ابتدایی در پایتون
 
-* **سطح متوسط:** دروس ۱۲ تا ؟، آشنایی با مفاهیم و ساختارهای پیچیده و ضروری در پایتون
+* **سطح متوسط:** دروس ۱۲ تا ؟، آشنایی با مفاهیم و ساختارهای پیچیده و ضروری در پایتون
 
-* **سطح پیشرفته:** دروس ؟ تا ؟، آشنایی با مفاهیم و ماژول‌های حرفه‌ای در پایتون
+* **سطح پیشرفته:** دروس ؟ تا ؟، آشنایی با مفاهیم و ماژول‌های حرفه‌ای در پایتون
 
 
 

lessons/l25.rst

@@ -18,6 +18,7 @@
 
 
 
+برای کار با زمان سه ماژول در کتابخانه استاندارد زبان برنامه‌نویسی پایتون آماده شده است؛ time ،datetime و calendar. این درس به شرح کامل ماژول datetime پایتون اختصاص یافته است و دو ماژول دیگر توسط درس بعد بررسی خواهند شد. ماژول datetime پایتون انواع یا کلاس‌های زیادی را برای ایجاد اشیا مرتبط با زمان و دستکاری (manipulating) آن‌ها فراهم آورده است، همچون ``time`` ،``date`` ،``timezone`` ،``timedelta`` و ``datetime`` که همگی در این درس بررسی خواهند شد.
 
 توجه داشته باشید، هم اکنون پشتیبانی نسخه 2x پایتون به پایان رسیده است. بنابراین به منظور جلوگیری از پیچیدگی‌های غیر ضروری، تمام مطالب این درس بر مبنای پایتون 3x ارائه می‌شود.
 
@@ -42,7 +43,7 @@
 
 * **کلاس** ``date``: مناسب برای ایجاد شی تاریخ در پایتون می‌باشد که اشیا آن هیچ آگاهی نسبت به ساعت و منطقه زمانی (Time zone) [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Time_zone>`__] نخواهند داشت و تنها مربوط به روزی خاص بر اساس گاه‌شماری میلادی (Gregorian calendar) [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Gregorian_calendar>`__] می‌باشند.
 
-* **کلاس** ``time``: مناسب برای ایجاد شی ساعت در پایتون می‌باشد و اشیا این کلاس هیچ آگاهی نسبت به تاریخ یا روز خاصی ندارند و تنها حاوی یک زمان مشخص از شبانه‌روز خواهند بود.
+* **کلاس** ``time``: مناسب برای ایجاد شی ساعت در پایتون می‌باشد و اشیا این کلاس هیچ آگاهی نسبت به تاریخ یا روز خاصی ندارند و تنها حاوی یک ساعت مشخص از شبانه‌روز خواهند بود.
 
 * **کلاس** ``datetime``: ترکیبی از دو کلاس ``date`` و ``time`` که اشیای آن می‌توانند نسبت به یک زمان (تاریخ و ساعت) مشخص آگاهی کامل داشته باشند.
 
@@ -182,7 +183,8 @@
 
 هر وقت که صحبت از ساعت و زمان باشد، «منطقه زمانی» (Time zone) نیز جزئی از گفتگو خواهد بود. در زبان برنامه‌نویسی پایتون کلاس ``tzinfo`` از ماژول ``datetime`` امکان ایجاد منطقه زمانی را فراهم آورده است [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#datetime.tzinfo>`__]. ``tzinfo`` در واقع یک کلاس Abstract (درس نوزدهم) می‌باشد که نمی‌توان از آن نمونه‌سازی و شی ایجاد کرد ولی می‌توان به کمک آن، کلاس منطقه زمانی دلخواه خود را ایجاد نماییم. برای مشاهده اجزا و نکات مربوط به پیاده‌سازی منطقه زمانی دلخواه می‌توانید به مستندات زبان برنامه‌نویسی پایتون مراجعه نمایید. 
 
-اشتباه نکنید، در اکثر مواقع نیازی به پیاده‌سازی یک کلاس منطقه زمانی در پایتون نمی‌باشد. چرا که از قبل کلاس ``timezone`` از ماژول ``datetime`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#timezone-objects>`__] توسط این زبان فراهم آورده شده است. این کلاس یک subclass از ``datetime.tzinfo`` بوده و مبنای محاسبه منطقه زمانی در آن UTC [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Coordinated_Universal_Time>`__] می‌باشد. این کلاس به تنهایی تمامی نیازهای معمول ما نسبت به ثبت منطقه زمانی در پایتون را برطرف می‌سازد. در سراسر ایران منطقه زمانی یکسان می‌باشد و به صورت استاندارد از مبنای UTC محاسبه می‌گردد؛ به این صورت که در شش ماه نخست سال برابر ``UTC+4:30`` و در شش ماه دوم از سال این مقدار برابر ``UTC+3:30`` خواهد بود [`ویکی‌پدیا Iran Standard Time (IRST) <https://en.wikipedia.org/wiki/Iran_Standard_Time>`__].
+اشتباه نکنید، در اکثر مواقع نیازی به پیاده‌سازی یک کلاس منطقه زمانی در پایتون نمی‌باشد. چرا که از قبل کلاس ``timezone`` از ماژول ``datetime`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#timezone-objects>`__] توسط این زبان فراهم آورده شده است. این کلاس یک subclass از ``datetime.tzinfo`` بوده و مبنای محاسبه منطقه زمانی در آن UTC [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Coordinated_Universal_Time>`__] می‌باشد. UTC یک قرارداد جهانی است و این کلاس به تنهایی تمامی نیازهای معمول ما نسبت به ثبت منطقه زمانی در پایتون را برطرف می‌سازد. برای مثال، در سراسر ایران منطقه زمانی یکسان می‌باشد و به صورت استاندارد از مبنای UTC محاسبه می‌گردد؛ به این صورت که در شش ماه نخست سال برابر ``UTC+4:30`` - با شمارش ساعت تابستانی [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Daylight_saving_time>`__] - و در شش ماه دوم از سال این مقدار برابر ``UTC+3:30`` خواهد بود [`ویکی‌پدیا Iran Standard Time (IRST) <https://en.wikipedia.org/wiki/Iran_Standard_Time>`__].
+
 
 .. note::
 
@@ -210,7 +212,7 @@
  >>> type(tz)
  <class 'datetime.timezone'>
 
-شی ``tz`` ایجاد شده در نمونه کد بالا، بیانگر منطقه زمانی ``UTC+4:30`` می‌باشد. به عنوان مثالی دیگر، ایجاد شی برای منطقه زمانی ``UTC-05:00`` به صورت زیر می‌باشد::
+شی ``tz`` ایجاد شده در نمونه کد بالا، بیانگر منطقه زمانی ``UTC+4:30`` (Asia/Tehran، با شمردن ساعت تابستانی) می‌باشد. به عنوان مثالی دیگر، ایجاد شی برای منطقه زمانی ``UTC-05:00`` (EST، بدون شمردن ساعت تابستانی) [`ویکی‌پدیا <https://en.wikipedia.org/wiki/Eastern_Time_Zone>`__] به صورت زیر می‌باشد::
 
 
  >>> tz = timezone(timedelta(hours=-5), 'Eastern Time Zone')

log.rst

@@ -13,6 +13,17 @@
 
 
 
+.. raw:: html
+
+ <pclass="rubric"id="00126" ><aclass="reference external"href="#00126">00126</a> - جمعه ۲۷ فروردین ۱۴۰۰</p>
+
+
+* درس بیست و پنجم با عنوان «زمان در پایتون: ماژول‌ datetime » به فهرست کتاب افزوده شد.
+* بروزرسانی: توضیحی کوتاه به بخش «property@» از درس بیست و یکم پیرامون «ایجاد Attributeهای read-only» اضافه گردید.
+* فونت قالب از «بهداد» به «وزیر» تغییر داده شد.
+
+----
+
 
 .. raw:: html