متد ()strptime در پایتون — به زبان ساده

در این مطلب، چگونگی ساخت شی datetime از یک رشته در «زبان برنامه‌نویسی پایتون» (Python Programming Language) با بهره‌گیری از مثال‌های گوناگون آموزش داده شده است. متد ()strptime یک شی datetime را از یک رشته داده شده می‌سازد. شایان توجه است که نمی‌توان شی datetime را از هر رشته‌ای ساخت. رشته باید در یک قالب خاص باشد. مثال زیر در این راستا قابل توجه است.

مثال ۱: تبدیل رشته به شی datetime

from datetime import datetime

date_string = "21 June, 2018"

print("date_string =", date_string)
print("type of date_string =", type(date_string))

date_object = datetime.strptime(date_string, "%d %B, %Y")

print("date_object =", date_object)
print("type of date_object =", type(date_object))

خروجی قطعه کد بالا، به صورت زیر است.

date_string = 21 June, 2018
type of date_string = <class 'str'>
date_object = 2018-06-21 00:00:00
type of date_object = <class 'datetime.datetime'>

روش کار متد ()strptime

متد کلاس ()strptime دارای دو آرگومان است.

• رشته (به datetime تبدیل می‌شود)
• کد فرمت

فیلم آموزش کتابخانه استاندارد پایتون در فرادرس

کلیک کنید

بسته به رشته و کد فرمت استفاده شده، متد، شی datetime معادل آن را باز می‌گرداند. توضیحات مربوط به کد مثال ارائه شده در بالا، در ادامه بیان شده است.

• d%: نشانگر روز ماه است. مثال: 01, 02, ..., 31.
• B%: نام ماه کامل است. برای مثال: February ،January و دیگر موارد.
• Y%: سال در چهار رقم. مثال: ۲۰۱۸، ۲۰۱۹ و دیگر موارد.

فیلم آموزش برنامه نویسی پایتون + مثال های عملی در Python در فرادرس

کلیک کنید

در ادامه، مثال دیگری از متد ()strptime ارائه شده است.

مثال ۲: تبدیل رشته به شی datetime

from datetime import datetime

dt_string = "12/11/2018 09:15:32"

# Considering date is in dd/mm/yyyy format
dt_object1 = datetime.strptime(dt_string, "%d/%m/%Y %H:%M:%S")
print("dt_object1 =", dt_object1)

# Considering date is in mm/dd/yyyy format
dt_object2 = datetime.strptime(dt_string, "%m/%d/%Y %H:%M:%S")
print("dt_object2 =", dt_object2)

خروجی حاصل از اجرای قطعه کد بالا، به صورت زیر است.

dt_object1 = 2018-11-12 09:15:32
dt_object2 = 2018-12-11 09:15:32

لیست کدهای فرمت

در جدول زیر، همه کدهای فرمت قابل استفاده، ارائه شده است.

ValueError در ()strptime

اگر رشته (اولین آرگومان) و کد فرمت (دومین آرگومان) پاس داده شده به ()strptime با یکدیگر تطبیق پیدا نکنند، ValueError نمایش داده می‌شود. نمونه‌ای از کدی که با ValueError مواجه می‌شود در ادامه ارائه شده است.

from datetime import datetime

date_string = "12/11/2018"
date_object = datetime.strptime(date_string, "%d %m %Y")

print("date_object =", date_object)

در صورت اجرای قطعه کد بالا، خطای زیر نمایش داده خواهد شد.

ValueError: time data '12/11/2018' does not match format '%d %m %Y'

اگر نوشته بالا برای شما مفید بوده است، آموزش‌های زیر نیز به شما پیشنهاد می‌شوند:

• مجموعه آموزش‌های برنامه‌نویسی پایتون
• آموزش تکمیلی برنامه‌نویسی پایتون
• مجموعه آموزش‌های داده‌کاوی و یادگیری ماشین
• زبان برنامه‌نویسی پایتون (Python) — از صفر تا صد
• یادگیری علم داده (Data Science) با پایتون — از صفر تا صد
• آموزش پایتون (Python) — مجموعه مقالات جامع وبلاگ فرادرس

^^