l25: strptime, strftime - working

Author: Saeid Darvish

lessons/l25.rst

@@ -1243,9 +1243,77 @@ naive / aware
 متدهای ``strftime`` و ``strptime``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+پیش‌تر با این دو متد آشنا شده‌ایم، ولی به صورت خلاصه می‌توان این دو متد را اینگونه تعریف نمود:
 
 
 
+**متد** ``strftime(format)``: یک Instance method بوده و از جانب هر سه نوع شی ``date`` ،``time`` و ``datetime`` پشتیبانی و قابل استفاده می‌باشد. این متد می‌تواند زمان شی مورد نظر را به یک قالب (format) مشخص از شی رشته ``str`` تبدیل نماید. (str format time)
+
+
+**متد** ``strptime(date_string, format)``: یک Class method بوده و تنها از جانب کلاس ``datetime`` پشتیبانی و قابل استفاده می‌باشد. این متد می‌تواند زمان درج شده در یک قالب (format) مشخص از شی رشته ``str`` را تجزیه (Parse) و به یک شی ``datetime.datetime`` تبدیل نماید. (str parse time)
+
+در هر دوی این متدها منظور از format در پارامترهای ورودی، یک رشته متنی است که بر اساس کدهای خاصی تشکیل شده است و همینطور date_string نیز یک رشته متنی حاوی زمان در قالب ارايه شده توسط format می‌باشد. به نمونه کد زیر توجه نمایید::
+
+
+    >>> import datetime
+    >>> today = datetime.datetime(2021, 4, 15, 12, 0, 0)
+    >>> today.strftime('%Y-%m-%d %H:%M:%S')
+    '2021-04-15 12:00:00'
+
+::
+
+    >>> import datetime
+    >>> datetime.datetime.strptime('2021-04-15 12:00:00', '%Y-%m-%d %H:%M:%S')
+    datetime.datetime(2021, 4, 15, 12, 0)
+
+
+برای مشاهده فهرست کدهای قابل استفاده و مفهوم آن‌ها در format می‌توانید به [`اسناد پایتون <https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes>`__] مراجعه نمایید ولی برخی از موارد پر استفاده به شرح زیر می‌باشند:
+
+
+* ``Y%``: نمایش سال به همراه قرن (چهار رقمی)
+
+* ``y%``: نمایش سال بدون قرن (دو رقمی)
+
+* ``m%``: نمایش شماره ماه به صورت دورقمی: 01 ... 12
+
+* ``b%``: نمایش نام ماه به صورت اختصار: Jan ... Dec
+
+* ``B%``: نمایش نام ماه به صورت کامل: January ... December
+
+* ``d%``: نمایش شماره روز از ماه به صورت دو رقمی: 01 ... 31
+
+* ``a%``: نمایش نام روز هفته به صورت اختصار: Sat ... Fri
+
+* ``A%``: نمایش نام روز هفته به صورت کامل: Saturday ... Friday
+
+* ``H%``: نمایش ساعت (در سیستم شمارش تا 24) به صورت دو رقمی: 00 ... 23
+
+* ``I%``: نمایش ساعت (در سیستم شمارش تا 12) به صورت دو رقمی: 00 ... 12
+
+* ``p%``: نمایش AM یا PM
+
+* ``M%``: نمایش دقیقه به صورت دو رقمی: 00 ... 59
+
+* ``S%``: نمایش ثانیه به صورت دو رقمی: 00 ... 59
+
+* ``Z%``: نمایش نام منطقه زمانی : UTC ,GMT, ....
+
+* ``%%``: نمایش یک کاراکتر ``%``
+
+
+::
+
+    >>> import datetime
+    >>> today = datetime.datetime(2021, 4, 15, 12, 0, 0)
+    >>> today.strftime('%b %d %Y %H:%M:%S')
+    'Apr 15 2021 12:00:00'
+
+
+::
+
+    >>> import datetime
+    >>> datetime.datetime.strptime('Apr 15 2021 12:00:00', '%b %d %Y %H:%M:%S')
+    datetime.datetime(2021, 4, 15, 12, 0)