學習自：datetime — Basic date and time types — Python 3.10.0b2 documentation

datetime模組用於操作date和time。

date和time物件可以分成“感知型”和“簡單型”兩種，分類方法取決於這類物件是否包含時區(timezone)資訊。

感知型，代表了一個特定的有意義的時間，比如“北京12:03”、“莫斯科 7:03”

簡單型，並不包含任何的定位資訊，只是表明用於計算的時間，比如“這段路程花費了2小時14分36秒”

在使用“感知型”時間時，datetime和time物件需要包含時區資訊，即在構建這類物件時設定引數tzinfo

Class

1. datetime.date：日期類，只有year、month、day三個引數；
2. datetime.time：時間類，引數包含hour、minute、second、microsecond、tzinfo；
3. datetime.datetime：時間和日期的結合，引數有year、month、day、hour、minute、second、microsecond、tzinfo；
4. datetime.timedelta：兩個date、time、datetime間的時間間隔；
5. datetime.tzinfo：包含時空資訊的抽象類，經常被datetime
   和time用於時間轉化；
6. datetime.timezone：用UTC時間實現tzinfo抽象類的類；

這些類的繼承關係：

timedelta
tzinfo        -> timezone
time
date         -> datetime

確定一個class是“感知型”還是“簡單型”

date物件一定是“簡單型”；

time、datetime可能是這兩種型別，那麼如何判斷呢？

“感知型” datetime或time物件x：

1. x.tzinfo 不是None；
2. x.tzinfo.utcoffset(d)不返回None。

其他時候，x都是簡單型。

timedelta

timedelta物件代表兩個date、time之間的持續時間。

構造方法

datetime.timedelta(
    days=0,seconds=0,microseconds=0,
    milliseconds=0,minutes=0,weeks=0
)

所有的引數都是可選的，預設值都為0。所有的引數可以是整型或浮點型，整數或浮點數；

記憶體中儲存的只有days、seconds、microseconds，其他引數都可以被轉化：

• 1ms = 1000 microseconds；
• 1min = 60 s;
• 1hour = 3600 s;
• 1week= 7 days;

days、seconds、microseconds會被規格化儲存，這樣它們的值都是唯一的，規則是：

• 0 <= microseconds < 100000;
• 0 <= seconds < 3600*24;
• -99999999<= days <= 99999999;

下邊這個例子展示了除了days、seconds、microseconds之外的引數如何被轉化為上述這三個引數：

delta = timedelta(
    days=50,seconds=27,microseconds=10,
    milliseconds=29000,minutes=5,hours=8,weeks=2
)

delta
datetime.timedelta(days=64, seconds=29156, microseconds=10)

類屬性

timedelta.resolution：精度（兩個不等的timedelta物件之間的可能的最小時間間隔），預設是1μs，即timedelta( microseconds = 1 )

運算

在看以下的運算時，一定要把下邊的時間想成這種概念，從A到B需要 t小時

除了以上所說的運算，timedelta物件也支援加減date和datetime物件。

此外，也支援兩個timedelta間用比較運算子進行比較。

例項方法

timedelta.total_seconds()：返回持續時間的總秒數。

例子

關於規格化的例子：

>>> from datetime import timedelta
>>> year = timedelta(days=365)
>>> another_year = timedelta(weeks=40, days=84, hours=23,
...                          minutes=50, seconds=600)
>>> year == another_year
True
>>> year.total_seconds()
31536000.0

關於timedelta計算的例子：

>>> from datetime import timedelta
>>> year = timedelta(days=365)
>>> ten_years = 10 * year
>>> ten_years
datetime.timedelta(days=3650)
>>> ten_years.days // 365
10
>>> nine_years = ten_years - year
>>> nine_years
datetime.timedelta(days=3285)
>>> three_years = nine_years // 3
>>> three_years, three_years.days // 365
(datetime.timedelta(days=1095), 3)

date

一個date物件代表了一個有著year、month、day的date。

建構函式

datetime.date(year,month,day)

所有引數都需要明確指定，且這些引數必須是整型且需要在指定範圍內：

• MINYEAR <= year <= MAXYEAR
• 1 <= month <= 12
• 1<= day <= 該年該月最大天數

類方法：用法date.xxx(...)

類屬性：用法date.xxx

運算

例項方法：用法d.xxx(...)

例子

計算到某個日期的天數差：

from datetime import date

today=date.today()
my_birthday=date(today.year,5,24)
if my_birthday < today:#如果生日已經過完
    my_birthday=my_birthday.replace(year=today.year+1)
time2birthday=my_birthday-today
print(time2birthday.days)

time

time物件代表了一個獨立的時間。如果想要與真實的時間關聯（比如“北京 12:00”），需要通過tzinfo物件。

建構函式

time(
    hour=0, minute=0, second=0, microsecond=0,
    tzinfo=None, *, fold=0
)

所有的引數都是可選的；引數tzinfo要麼是None，要麼是tzinfo物件；其他引數必須是整數而且必須在指定的範圍內：

• 0 <= hour < 24;
• 0 <= minute < 60;
• 0 <= second <60;
• 0 <= microsecond < 1000000;
• fold in [ 0 , 1 ];

類屬性:用法time.xxx

物件屬性：用法t.xxx

需要注意的是，tzinfo標識一個time物件是“感知型”還是“簡單型”，沒有tzinfo屬性（“簡單型”）和有tzinfo屬性（“感知型”）的兩個time無法比較。

如果兩個time都有tzinfo屬性，表明它們都是“感知型”。如果它們的tzinfo屬性相同，那麼在比較時會忽略tzinfo而只比較基本時間；如果它們的tzinfo不同，那麼它們在比較時會轉化為UTC時間再進行比較。

類方法：用法time.xxx(...)

例項方法：用法t.xxx(...)

此外，格式化字串時也可以提取time物件的屬性之一進行格式化：

'{:%H:%M}'.format(t)
'12:10'

第一個:是格式化字串的標誌，第二個:是時間屬性分隔符。

例子

time.fromisoformat( str )

from datetime import time

time.fromisoformat('04:23:01')
datetime.time(4, 23, 1)

time.fromisoformat('04:23:01.000384')
datetime.time(4, 23, 1, 384)

time.fromisoformat('04:23:01+04:00')
datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))

time物件的相關方法

from datetime import time,tzinfo,timedelta
class TZ1(tzinfo): #TZ1是tzinfo的子類
    def utcoffset(self,dt):
        return timedelta(hours=1)
    def dst(self,dt):
        return timedelta(0)
    def tzname(self,dt):
        return '+01:00'
    def __repr__(self):
        return f'{self.__class__.__name__}()'

t = time(12,10,30,tzinfo=TZ1())
t
datetime.time(12, 10, 30, tzinfo=TZ1())

t.isoformat()
'12:10:30+01:00'

t.dst()
datetime.timedelta(0)

t.tzname()
'+01:00'

t.strftime("%H:%M%S %Z")
'12:10:30 +01:00'

'The {} is {:%H:%M}'.format('time',t)
'The time is 12:10'

datetime

datetime物件同時包含了time和date資訊。

建構函式

datetime.datetime(
    year, month, day, hour=0, minute=0,
    second=0, microsecond=0, tzinfo=None,
    *, fold=0
)

各項的範圍：

• MINYEAR<=year<=MAXYEAR,

• 1<=month<=12,

• 1<=day<=numberofdaysinthegivenmonthandyear,

• 0<=hour<24,

• 0<=minute<60,

• 0<=second<60,

• 0<=microsecond<1000000,

• foldin[0,1].

類方法：用法datetime.xxx( ... )

關於fromisoformat的例子：

>>> from datetime import datetime

>>> datetime.fromisoformat('2011-11-04')
datetime.datetime(2011, 11, 4, 0, 0)

>>> datetime.fromisoformat('2011-11-04T00:05:23')
datetime.datetime(2011, 11, 4, 0, 5, 23)

>>> datetime.fromisoformat('2011-11-04 00:05:23.283')
datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)

>>> datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')
datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone.utc)

>>> datetime.fromisoformat('2011-11-04T00:05:23+04:00')   
datetime.datetime(2011, 11, 4, 0, 5, 23,
    tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))

類屬性

time.resolution：精度，預設timedelta( microsecond=1 )

物件屬性：用法t.xxx

運算

例項方法：用法t.xxx(...)

例子

from datetime import datetime,date,time

d=date(2005,7,14)
t=time(12,30)
datetime.combine(d,t)
datetime.datetime(2005, 7, 14, 12, 30)

datetime.now()
datetime.datetime(2021, 6, 10, 15, 24, 1, 58813)

dt = datetime.strptime("21/11/06 16:30","%d/%m/%y %H:%M")
dt
datetime.datetime(2006, 11, 21, 16, 30)

tt=dt.timetuple()
tt
time.struct_time(tm_year=2006, tm_mon=11, tm_mday=21, tm_hour=16, tm_min=30, tm_sec=0, tm_wday=1, tm_yday=325, tm_isdst=-1)

ic = dt.isocalendar()
ic
(2006, 47, 2)

dt.strftime("%A, %d. %B %Y %I:%M%p")
'Tuesday, 21. November 2006 04:30PM'


'The {1} is {0:%d},the {2} is {0:%B}, the {3} is {0:%I:%M%p}'.format(dt,'day','month','year')
'The day is 21,the month is November, the year is 04:30PM'