l25: work on date class

Saeid Darvish · Saeid Darvish · commit de9bea533399 · 2021-04-07T21:54:03.000+04:30
diff --git a/lessons/l21.rst b/lessons/l21.rst
@@ -745,6 +745,39 @@ property@
 .. tip:: 
 
   از ``property@`` تنها برای Instance Attributeها می‌توان استفاده کرد.
+
+
+یک کاربرد پنهان در استفاده از ``property@``، امکان ایجاد Attributeهای **read-only** و غیرقابل تغییر پس از نمونه‌سازی شی خواهد بود. برای این منظور تنها کافی است از پیاده‌سازی متد setter صرف‌نظر کنیم! به نمونه کد پایین توجه نمایید:
+
+
+.. code-block:: python
+    :linenos:
+
+    class StaticNumber:
+
+        def __init__(self, number):
+            self._number = number
+
+        @property
+        def number(self):
+            return self._number
+
+
+
+    obj = StaticNumber(number='000111')
+
+    obj.number = '000222'
+
+::
+
+    Traceback (most recent call last):
+      File "sample.py", line 14, in <module>
+        obj.number = '000222'
+    AttributeError: can't set attribute
+
+
+
+
   
   
 Context Manager و دستور ``with/as``
diff --git a/lessons/l25.rst b/lessons/l25.rst
@@ -55,6 +55,74 @@
 کلاس ``datetime.date``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+این کلاس نمایش ایجاد یک شی تاریخ در زبان برنامه‌نویسی پایتون می‌باشد. در ادامه این بخش به بررسی چگونگی ایجاد شی و اجزای آن خواهیم پرداخت.
+
+ایجاد شی تاریخ
+------------------
+
+**۱- با استفاده از نمونه‌سازی**::
+
+    >>> import datetime
+
+    >>> date = datetime.date(2021, 4, 7)
+
+
+یا ::
+
+
+    >>> import datetime
+
+    >>> date = datetime.date(year=2021, month=4, day=7)
+
+که::
+
+    >>> date
+    datetime.date(2021, 4, 7)
+
+    >>> type(date)
+    <class 'datetime.date'>
+
+::
+
+    >>> date.year
+    2021
+    >>> date.month
+    4
+    >>> date.day
+    7
+
+برای نمونه‌سازی از کلاس ``datetime.date`` می‌بایست سه Instance attribute آن را مقداردهی نماییم. این سه attribute عبارتند از:
+
+* ``year``: از نوع ``int`` می‌باشد و مقداری برابر با سال مورد نظر خواهد داشت. این مقدار می‌بایست کمتر یا برابر ``datetime.MAXYEAR`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#datetime.MAXYEAR>`__] و همچنین بیشتر یا برابر ``datetime.MINYEAR`` [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#datetime.MINYEAR>`__] باشد (``MINYEAR <= year <= MAXYEAR``). 
+
+* ``month``: از نوع ``int`` می‌باشد و مقداری برابر با ماه مورد نظر خواهد داشت که می‌بایست عددی از بین اعداد ``1`` تا ``12`` باشد.
+
+* ``day``: از نوع ``int`` می‌باشد و مقداری برابر با روزی مشخص در ماه ذکر شده خواهد داشت.
+
+
+
+  ::
+
+      >>> datetime.MINYEAR
+      1
+      >>> datetime.MAXYEAR
+      9999
+
+      >>> datetime.MINYEAR <= date.year <= datetime.MAXYEAR
+      True
+      >>> 1 <= date.month <= 12
+      True
+      >>> 1 <= date.day <= 31
+      True
+
+باید توجه داشت که مقدار این سه attribute پس از نمونه‌سازی قابل تغییر نخواهد بود و به اصطلاح read-only هستند::
+
+    >>> date.year = 2022
+    Traceback (most recent call last):
+      File "<stdin>", line 1, in <module>
+    AttributeError: attribute 'year' of 'datetime.date' objects is not writable
+
+
 
 کلاس ``datetime.time``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
