Python 使用 datetime isoformat 的正確姿勢

Posted on  Dec 10, 2020  in  Python 程式設計 - 初階  by  Amo Chen  ‐ 1 min read

近來查閱 Python 關於 datetime 的標準日期格式(datetime.isoformat)的時候,發現一個奇妙的行為,該行為可能造成日期格式不一致。

本文環境

  • Python 3.7

isoformat

Python 的 isoformat() 預設有 2 個參數,其中 1 個是 timespec , timespec 預設是 auto ,當設定為 auto 時, isoformat 會根據 datetime.utcoffset() 以及 microsecond 的不一樣,而自動產生 4 種不同格式的字串:

  • YYYY-MM-DDTHH:MM:SS.ffffff
  • YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]
  • YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]

例如當 microseconds 為 0 與不為 0 的時候,就會產生 2 種格式:

>>> from datetime import datetime, timezone
>>> datetime(2019, 5, 18, 20, 17, 8, 0).isoformat()
'2019-05-18T20:17:08'
>>> datetime(2019, 5, 18, 20, 17, 8, 1).isoformat()
'2019-05-18T20:17:08.000001'

以及當 datetime 有時區資訊時,也會有 2 種不同的格式:

>>> from datetime import datetime, timezone
>>> datetime.now().isoformat()
'2019-05-18T20:17:08.513482'
>>> datetime.now(timezone.utc).isoformat()
'2019-05-18T20:17:08.827410+00:00'

上述 2 種情況就會產生 4 種排列組合。

雖然大部分的使用情況並不會讓人感覺到使用上的問題,但如果是對於有嚴格要求日期格式必須一致的系統,預設的 timespec='auto' 就會有機會產生非預期的格式,進而導致系統發生問題。

如果要解決這問題的話,就必須檢查 datetime object 是否有時區資訊,以及視時間的精準度需求將 timespec 改為以下的選項之一:

  • hours
  • minutes
  • seconds
  • milliseconds
  • microseconds

例如,以下是確保所有的字串都符合 YYYY-MM-DDTHH:MM:SS 格式的範例:

def get_isoformat(dt: datetime):
    if dt.utcoffset() is not None:
        raise ValueError('system does not support timezone')
    return dt.isoformat(timespec='seconds')

以上。

Happy Coding!

References

https://docs.python.org/3/library/datetime.html#datetime.datetime.isoformat

對抗久坐職業傷害

研究指出每天增加 2 小時坐著的時間,會增加大腸癌、心臟疾病、肺癌的風險,也造成肩頸、腰背疼痛等常見問題。

然而對抗這些問題,卻只需要工作時定期休息跟伸展身體即可!

你想輕鬆改變現狀嗎?試試看我們的 PomodoRoll 番茄鐘吧! PomodoRoll 番茄鐘會根據你所設定的專注時間,定期建議你 1 項辦公族適用的伸展運動,幫助你打敗久坐所帶來的傷害!

贊助我們的創作

看完這篇文章了嗎? 休息一下,喝杯咖啡吧!

如果你覺得 MyApollo 有讓你獲得實用的資訊,希望能看到更多的技術分享,邀請你贊助我們一杯咖啡,讓我們有更多的動力與精力繼續提供高品質的文章,感謝你的支持!