Python 常用日期處理 -- calendar 與 dateutil 模組
本文緊承上一篇Python 常用日期處理，因制於篇幅的大小需求才臨時分立新篇，這裡要簡單提到 calendar 和 dateutil 模組的使用，其中 calendar 是 Python 內建的。相比於上一篇而言，此處主旨會更明確一些，只記錄三個應用案例，分別是
- 用 dateutil 靈活的解析 datetime 字串
- 給定起始日期後的連續日期
- 給定起始日期後連續的月末日期
dateutil 靈活的解析 datetime 字串
使用 Python 內容的 date 或 datetime, 構造它們的例項時需要逐個的傳入年月日或時分秒，或者要呼叫fromisoformat()
方法解析嚴格的字串表示格式。而 dateutil.parser 的 parse() 方法就顯得特別的聰明和隨意，它可以智慧的解析更豐富的字串表示方式。詳細的支援格式請參考官方文件的parse examples
，恐怕官方文件也未列舉完全，只要覺得合理的時間字串就可以嘗試去解析。下方是一些例子
>>> from dateutil.parser import parse
>>>
>>> parse('2018-02-28')
datetime.datetime(2018, 2, 28, 0, 0)
>>> parse('2018-02-28T12:08:23')
datetime.datetime(2018, 2, 28, 12, 8, 23)
>>> parse('2018-02-28T12:08:23PM') # 下午
datetime.datetime(2018, 2, 28, 12, 8, 23)
>>> parse('2018-02-28T12:08:23+05:00') # 加上時區偏移
datetime.datetime(2018, 2, 28, 12, 8, 23, tzinfo=tzoffset(None, 18000))
>>> parse('Jan 18, 2018')
datetime.datetime(2018, 1, 18, 0, 0)
>>> parse('Oct. 10, 2008 10:43am CST') # 加上時區
datetime.datetime(2008, 10, 10, 10, 43, tzinfo=tzlocal())
>>> parse('Wed Jul 08 17:08:48 GMT 2009')
datetime.datetime(2009, 7, 8, 17, 8, 48, tzinfo=tzutc())
>>> parse("09-25-2003")
datetime.datetime(2003, 9, 25, 0, 0)
>>> parse("13-02-2003") # 第一段大於 12 不可能是月份，所以推斷為日期
datetime.datetime(2003, 2, 13, 0, 0)
>>>parse('09:23pm')
datetime.datetime(2019, 4, 30, 21, 23)
parser.parse() 返回的總是 datetime 型別，這也很好理解，因為 datetime 有完整的時間資訊，可由此得到 date 或 time 例項。
給定起始日期後的連續日期
從一個給定日期一天天往後推可以直接用 Python 內建的 datetime(date 和 timedelta)，還用不上 calendar 模組
>>> from datetime import date, timedelta >>> start_date = date(2018, 2, 25) >>> for i in range(1, 10): ... print(start_date + timedelta(days = i)) ... 2018-02-26 2018-02-27 2018-02-28 2018-03-01 2018-03-02 2018-03-03 2018-03-04 2018-03-05 2018-03-06
使用timedelta
來計算日期偏移只能支援以下的度量
timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)
不能按月，年來換算，而dateutil.relativedelta
就更強大了，看下它的建構函式
relativedelta(dt1=None, dt2=None, years=0, months=0, days=0, leapdays=0, weeks=0, hours=0, minutes=0, seconds=0, microseconds=0, year=None, month=None, day=None, weekday=None, yearday=None, nlyearday=None, hour=None, minute=None, second=None, microsecond=None)
我們可以換用 relativedelta 來重寫上面的程式碼
>>> from datetime import date >>> from dateutil.relativedelta import relativedelta >>> start_date = date(2018, 2, 25) >>> for i in range(1, 10): ... print(start_date + relativedelta(days = i)) ... 2018-02-26 2018-02-27 2018-02-28 2018-03-01 2018-03-02 2018-03-03 2018-03-04 2018-03-05 2018-03-06
如果想要推算下一個，下一個月，或下下年就需要用relativedelta
。
給定起始日期後連續的月末日期
假如用 relativedelta 按月推算日期的話就要涉及到 calendar 模組了，因為無論 30 天往下推算或是relativedelta(months = 1)
得到的都可能不是自己想要的結果。例如
- 2019-01-30 + relativedelta(months = 1) 是 2019-02-28
- 2019-02-28 + relativedelta(months = 1) 是 2019-03-28
日期部分飄忽不定，這種按月推演出的結果沒多大意思，一般來說我們可能需要的是每個月月末日期，可以使用 calendar 來確定指定年月的最小和最大日期。
>>> from datetime import date >>> from dateutil.relativedelta import relativedelta >>> from calendar import monthrange >>> >>> monthend = date(2019, 1, 31) >>> for i in range(1, 10): ... dd = monthend + relativedelta(months = i) ... dd = dd.replace(day = monthrange(dd.year, dd.month)[1]) ... print(dd) ... 2019-02-28 2019-03-31 2019-04-30 2019-05-31 2019-06-30 2019-07-31 2019-08-31 2019-09-30 2019-10-31
Python 自帶的 calendar 模組還有許多好玩的函式，如對星期，月份的遍歷，真正的日曆輸出為文字或 HTML 程式碼的功能，詳情請見Python CALENDAR Tutorial with Example .
來份簡單的例子
>>> import calendar >>> c = calendar.TextCalendar(calendar.SUNDAY) >>> str = c.formatmonth(2019, 4) >>> print(str) April 2019 Su Mo Tu We Th Fr Sa 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
顯示出與 bash 命令cal -h 4 2019
一樣的內容。