Python 标準庫之 datetime

1. datetime 簡介

datetime 是基于 time 子產品進行了封裝，提供了更進階的功能。該子產品主要有以下幾個類：

date： 表示日期的類。常用的屬性有 year, month, day

time： 表示時間的類。常用的屬性有 hour, minute, second, microsecond

datetime： 表示日期時間

timedelta： 表示時間間隔，即兩個時間點之間的長度

tzinfo： 與時區有關的相關資訊

2. date 類

2.1 date 類方法和類屬性

date 類定義了一些常用的類方法與類屬性:

max、min： date對象所能表示的最大、最小日期

resolution： date對象表示日期的最小機關。這裡是天

today()： 傳回一個表示目前本地日期的date對象

fromtimestamp(timestamp)： 根據給定的時間戮，傳回一個date對象

In [1]: from datetime import date

In [2]: date.max
Out[2]: datetime.date(9999, 12, 31)

In [3]: date.min
Out[3]: datetime.date(1, 1, 1)

In [4]: date.today
Out[4]: <function today>

In [5]: date.today()
Out[5]: datetime.date(2018, 11, 23)

In [6]: date.resolution
Out[6]: datetime.timedelta(1)

In [7]: import time

In [8]: date.fromtimestamp(time.time())
Out[8]: datetime.date(2018, 11, 23)
           

2.2 date 類的執行個體方法和屬性

date 提供的執行個體方法和屬性：

.year： 傳回年

.month： 傳回月

.day： 傳回日

.replace(year, month, day)： 生成一個新的日期對象，用參數指定的年，月，日代替原有對象中的屬性。（原有對象仍保持不變）

.weekday()： 傳回weekday，如果是星期一，傳回0；如果是星期2，傳回1，以此類推

.isoweekday()： 傳回weekday，如果是星期一，傳回1；如果是星期2，傳回2，以此類推

.isocalendar()： 傳回格式如(year, wk num, wk day)

.isoformat()： 傳回格式如’YYYY-MM-DD’的字元串

.strftime(fmt)： 自定義格式化字元串。與time子產品中的strftime類似

In [12]: today = date.today()

In [13]: today
Out[13]: datetime.date(2018, 11, 23)

In [14]: today.year
Out[14]: 2018

In [15]: today.month
Out[15]: 11

In [16]: today.day
Out[16]: 23

In [17]: today.weekday()
Out[17]: 4

In [18]: today.isoweekday()
Out[18]: 5

In [19]: today.isocalendar()
Out[19]: (2018, 47, 5)

In [21]: today.strftime("%Y-%m-%d %H:%M:%S")
Out[21]: '2018-11-23 00:00:00'

In [22]: today.isoformat()
Out[22]: '2018-11-23'
           

date 還對某些操作進行了重載，它允許我們對日期進行如下一些操作：

• date2 = date1 + timedelta # 日期加上一個間隔，傳回一個新的日期對象
• date2 = date1 – timedelta # 日期減去一個間隔，傳回一個新的日期對象
• timedelta = date1 – date2 # 兩個日期相減，傳回一個時間間隔對象
• date1 < date2 # 兩個日期進行比較

In [23]: from datetime import timedelta

In [24]: yestoday = today - timedelta(1)

In [25]: yestoday
Out[25]: datetime.date(2018, 11, 22)

In [26]: yestoday < today
Out[26]: True

In [27]: the_day_last_month = today - timedelta(30)

In [28]: the_day_last_month
Out[28]: datetime.date(2018, 10, 24)

In [29]: the_day_last_month < today
Out[29]: True
           

3. time 類

3.1 time 類定義的類屬性：

min、max： time 類所能表示的最小、最大時間。其中，time.min = time(0, 0, 0, 0)， time.max = time(23, 59, 59, 999999)

resolution： 時間的最小機關，這裡是1微秒

In [30]: from datetime import time

In [31]: time.min
Out[31]: datetime.time(0, 0)

In [32]: time.max
Out[32]: datetime.time(23, 59, 59, 999999)

In [33]: time.resolution
Out[33]: datetime.timedelta(0, 0, 1)
           

3.2 time 類的執行個體方法和屬性：

.hour、.minute、.second、.microsecond： 時、分、秒、微秒

.tzinfo： 時區資訊

.replace([hour[, minute[, second[, microsecond[, tzinfo]]]]])： 建立一個新的時間對象，用參數指定的時、分、秒、微秒代替原有對象中的屬性（原有對象仍保持不變）

.isoformat()： 傳回型如”HH:MM:SS”格式的字元串表示

.strftime(fmt)： 傳回自定義格式化字元串

像 date 一樣，也可以對兩個 time 對象進行比較，或者相減傳回一個時間間隔對象。

4. datetime 類

datetime 是 date 與 time的 結合體，包括 date 與 time 的所有資訊。它的構造函數如下：datetime.datetime(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])，各參數的含義與 date、time 的構造函數中的一樣，要注意參數值的範圍。

4.1 類屬性和方法

datetime 類定義的類屬性與方法：

• min、max： datetime 所能表示的最小值與最大值
• resolution： datetime最小機關
• today()： 傳回一個表示目前本地時間的datetime對象
• now([tz])： 傳回一個表示目前本地時間的datetime對象，如果提供了參數tz，則擷取tz參數所指時區的本地時間
• utcnow()： 傳回一個目前utc時間的datetime對象
• fromtimestamp(timestamp[, tz])： 根據時間戮建立一個datetime對象，參數tz指定時區資訊
• utcfromtimestamp(timestamp)： 根據時間戮建立一個datetime對象
• combine(date, time)： 根據date和time，建立一個datetime對象
• strptime(date_string, format)： 将格式字元串轉換為datetime對象

In [42]: from datetime import datetime

In [43]: datetime.min
Out[43]: datetime.datetime(1, 1, 1, 0, 0)

In [44]: datetime.max
Out[44]: datetime.datetime(9999, 12, 31, 23, 59, 59, 999999)

In [45]: datetime.resolution
Out[45]: datetime.timedelta(0, 0, 1)

In [46]: datetime.today()
Out[46]: datetime.datetime(2018, 11, 23, 18, 51, 33, 382000)

In [47]: datetime.now()
Out[47]: datetime.datetime(2018, 11, 23, 18, 51, 53, 771000)

In [48]: datetime.utcnow()
Out[48]: datetime.datetime(2018, 11, 23, 10, 52, 12, 749000)

In [49]: import time

In [50]: datetime.fromtimestamp(time.time())
Out[50]: datetime.datetime(2018, 11, 23, 18, 53, 37, 212000)

In [51]: datetime.utcfromtimestamp(time.time())
Out[51]: datetime.datetime(2018, 11, 23, 10, 54, 9, 287000)

In [54]: from datetime import date

In [55]: from datetime import time

In [56]: d = date(year=1900, month=10, day=15)

In [57]: d
Out[57]: datetime.date(1900, 10, 15)

In [58]: t = time(hour=20, minute=30, second=00)

In [59]: t
Out[59]: datetime.time(20, 30)

In [60]: datetime.combine(d,t)
Out[60]: datetime.datetime(1900, 10, 15, 20, 30)
           

4.2 執行個體屬性和方法

datetime 類提供的執行個體方法與屬性（很多屬性或方法在date和time中已經出現過，在此有類似的意義，這裡隻羅列這些方法名，具體含義不再逐個展開介紹，可以參考上文對date與time類的講解。）

• year、month、day、hour、minute、second、microsecond、tzinfo
• date()：擷取date對象
• time()：擷取time對象
• replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])
• timetuple()
• utctimetuple()
• toordinal()
• weekday()
• isocalendar()
• isoformat([sep])
• ctime()：傳回一個日期時間的C格式字元串，等效于time.ctime(time.mktime(dt.timetuple()))
• strftime(format)

像 date 一樣，也可以對兩個 datetime 對象進行比較，或者相減傳回一個時間間隔對象，或者日期時間加上一個間隔傳回一個新的日期時間對象。

最常用的是将時間字元格式化

import datetime
datetime.datetime.strptime("2019-03-24 03-11-17", "%Y-%m-%d %H-%M-%S")
           

傳回結果：

4.3 timedelta 類

通過 timedelta 函數傳回一個 timedelta 對象，也就是一個表示時間間隔的對象。函數參數情況如下所示:

其沒有必填參數，簡單控制的話第一個整數就是多少天的間隔的意思。

兩個時間間隔對象可以彼此之間相加或相減，傳回的仍是一個時間間隔對象。而更友善的是一個datetime 對象如果減去一個時間間隔對象，那麼傳回的對應減去之後的 datetime 對象，然後兩個datetime 對象如果相減傳回的是一個時間間隔對象。這很是友善。

參考連結：http://www.biaodianfu.com/python-datetime.html