datetime

1. 获取当前日期和时间

>>> from datetime import datetime
>>> datetime.now()
datetime.datetime(2018, 6, 15, 10, 29, 31, 816383)
>>> now = datetime.now() 
>>> print(now)
2018-06-15 10:30:29.151783
>>> print(type(now))
<class 'datetime.datetime'>

---

2. 用参数构造一个datetime

>>> help(datetime)
datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])

>>> from datetime import datetime
>>> dt = datetime(2015, 4, 19, 12, 20) 
>>> print(dt)
2015-04-19 12:20:00

---

3. datetime转换为timestamp

把一个datetime类型转换为timestamp只需调用timestamp()方法：

>>> from datetime import datetime
>>> dt = datetime(2015, 4, 19, 12, 20) 
>>> dt.timestamp() 
1429417200.0

或者
>>> datetime.timestamp(datetime(2015, 4, 19, 12, 20))
1429417200.0

注意:
Python的timestamp是一个浮点数，如果有小数位，小数位表示毫秒数。
某些编程语言（如Java和JavaScript）的timestamp使用整数表示毫秒数，
这种情况下只需要把timestamp除以1000就得到Python的浮点表示方法。

---

4. timestamp转换为datetime

>>> from datetime import datetime
>>> t = 1429417200.0
>>> print(datetime.fromtimestamp(t))
2015-04-19 12:20:00

---

5. str转换为datetime

用户输入的日期和时间是字符串，要处理日期和时间，首先必须把str转换为datetime。
转换方法是通过datetime.strptime()实现，需要一个日期和时间的格式化字符串：

>>> from datetime import datetime
>>> cday = datetime.strptime('2015-6-1 18:19:59', '%Y-%m-%d %H:%M:%S')
>>> print(cday)
2015-06-01 18:19:59

 Commonly used format codes:
    
    %Y  Year with century as a decimal number.
    %m  Month as a decimal number [01,12].
    %d  Day of the month as a decimal number [01,31].
    %H  Hour (24-hour clock) as a decimal number [00,23].
    %M  Minute as a decimal number [00,59].
    %S  Second as a decimal number [00,61].
    %z  Time zone offset from UTC.
    %a  Locale's abbreviated weekday name.
    %A  Locale's full weekday name.
    %b  Locale's abbreviated month name.
    %B  Locale's full month name.
    %c  Locale's appropriate date and time representation.
    %I  Hour (12-hour clock) as a decimal number [01,12].
    %p  Locale's equivalent of either AM or PM.

字符串'%Y-%m-%d %H:%M:%S'规定了日期和时间部分的格式。详细的说明请参考Python文档

---

6. datetime转换为str

>>> from datetime import datetime
>>> now = datetime.now()
>>> print(now.strftime('%a, %b %d %H:%M'))
Mon, May 05 16:28

---

7. datetime.timedelta 时间运算
   时间计算可以直接用+和-运算符。不过需要导入timedelta这个类，可用参数：days seconds microseconds milliseconds minutes hours weeks

import datetime, time

curr_now = datetime.datetime.now()
after_5min = curr_now - datetime.timedelta(minutes=5)
print(after_5min.strftime("%Y-%m-%d %H:%M:%S"))

# 可见，使用timedelta可以很容易地算出前几天和后几天的时刻
# minutes=-5 表示前5分钟

---

8. timestamp被转换到UTC标准时区的时间

>>> from datetime import datetime
>>> t = 1429417200.0
>>> print(datetime.fromtimestamp(t)) # 本地时间
2015-04-19 12:20:00
>>> print(datetime.utcfromtimestamp(t)) # UTC时间
2015-04-19 04:20:00

>>> print(datetime(2018, 6, 15, 12, 20))
2018-06-15 12:20:00  # 本地时间
>>> print(datetime.utcfromtimestamp(datetime.timestamp(datetime(2018, 6, 15, 12, 20))))    # UTC时间
2018-06-15 04:20:00

---

9. 本地时间转换为UTC时间

本地时间是指系统设定时区的时间，例如北京时间是UTC+8:00时区的时间，而UTC时间指UTC+0:00时区的时间。

一个datetime类型有一个时区属性tzinfo，但是默认为None，所以无法区分这个datetime到底是哪个时区，除非强行给datetime设置一个时区：

>>> from datetime import datetime, timedelta, timezone
>>> tz_utc_8 = timezone(timedelta(hours=8)) # 创建时区UTC+8:00
>>> now = datetime.now()
>>> now
datetime.datetime(2015, 5, 18, 17, 2, 10, 871012)
>>> dt = now.replace(tzinfo=tz_utc_8) # 强制设置为UTC+8:00
>>> dt
datetime.datetime(2015, 5, 18, 17, 2, 10, 871012, tzinfo=datetime.timezone(datetime.timedelta(0, 28800)))

# 如果系统时区恰好是UTC+8:00，那么上述代码就是正确的，否则，不能强制设置为UTC+8:00时区。

---

10. 时区转换
    我们可以先通过utcnow()拿到当前的UTC时间，再转换为任意时区的时间：

# 拿到UTC时间，并强制设置时区为UTC+0:00:
>>> utc_dt = datetime.utcnow().replace(tzinfo=timezone.utc)
>>> print(utc_dt)
2015-05-18 09:05:12.377316+00:00
# astimezone()将转换时区为北京时间:
>>> bj_dt = utc_dt.astimezone(timezone(timedelta(hours=8)))
>>> print(bj_dt)
2015-05-18 17:05:12.377316+08:00
# astimezone()将转换时区为东京时间:
>>> tokyo_dt = utc_dt.astimezone(timezone(timedelta(hours=9)))
>>> print(tokyo_dt)
2015-05-18 18:05:12.377316+09:00
# astimezone()将bj_dt转换时区为东京时间:
>>> tokyo_dt2 = bj_dt.astimezone(timezone(timedelta(hours=9)))
>>> print(tokyo_dt2)
2015-05-18 18:05:12.377316+09:00

时区转换的关键在于，拿到一个datetime时，要获知其正确的时区，然后强制设置时区，作为基准时间。
利用带时区的datetime，通过astimezone()方法，可以转换到任意时区。
注：不是必须从UTC+0:00时区转换到其他时区，任何带时区的datetime都可以正确转换，例如上述bj_dt到tokyo_dt的转换。

---

11. 小结
    datetime表示的时间需要时区信息才能确定一个特定的时间，否则只能视为本地时间。
    如果要存储datetime，最佳方法是将其转换为timestamp再存储，因为timestamp的值与时区完全无关。