【python时间处理】

神秘的doge

已于 2023-09-25 17:22:05 修改

阅读量235

点赞数 1

文章标签： python

于 2023-07-10 19:23:16 首次发布

本文链接：https://blog.csdn.net/sj13036141506/article/details/131559074

版权

格式化时间函数strftime的格式符详解

*relativedelta.relativedelta()

摘要：

Python的时间处理模块在日常的使用中用的较多，但是使用的时候基本上都是要查资料，还是有些麻烦的，梳理下，便于以后方便的使用。

time模块

在 Python 文档里，time是归类在Generic Operating System Services中，换句话说，它提供的功能是更加接近于操作系统层面的。通读文档可知，time 模块是围绕着 Unix Timestamp 进行的。

该模块主要包括一个类 struct_time，另外其他几个函数及相关常量。需要注意的是在该模块中的大多数函数是调用了所在平台C library的同名函数，所以要特别注意有些函数是平台相关的，可能会在不同的平台有不同的效果。另外一点是，由于是基于Unix Timestamp，所以其所能表述的日期范围被限定在 1970 – 2038 之间，如果你写的代码需要处理在前面所述范围之外的日期，那可能需要考虑使用datetime模块更好。

time() 返回时间戳格式的时间 (相对于1.1 00:00:00以秒计算的偏移量)
mktime()将一个以struct_time格式转换为时间戳
ctime() 返回字符串形式的时间，可以传入时间戳格式时间，用来做转化
asctime() 返回字符串形式的时间，可以传入struct_time形式时间，用来做转化
localtime() 返回当前时间的struct_time形式，可传入时间戳格式时间，用来做转化
gmtime() 返回当前时间的struct_time形式，UTC时区(0时区) ，可传入时间戳格式时间，用来做转化
time.strftime(format[,t]) 把一个struct_time时间转化为格式化的时间字符串。如果t未指定，将传入time.localtime()。如果元组中任何一个元素越界，ValueError的错误将会被抛出。
time.strptime(string[,format]) 把一个格式化时间字符串转化为struct_time。实际上它和strftime()是逆操作。
time.sleep() 线程推迟指定的时间运行。单位为秒

>>> import time
>>> time.time()
1473386416.954
>>> time.ctime()
'Fri Sep 09 10:00:25 2016'
>>> time.ctime(time.time())
'Fri Sep 09 10:28:08 2016'
>>> time.asctime()
'Fri Sep 09 10:22:40 2016'
>>> time.asctime(time.localtime())
'Fri Sep 09 10:33:00 2016'
>>> time.localtime()
time.struct_time(tm_year=2016, tm_mon=9, tm_mday=9, tm_hour=10, tm_min=1, tm_sec=19, tm_wday=4, tm_yday=253, tm_isdst=0)
>>> time.localtime(time.time())
time.struct_time(tm_year=2016, tm_mon=9, tm_mday=9, tm_hour=10, tm_min=19, tm_sec=11, tm_wday=4, tm_yday=253, tm_isdst=0)
>>> time.gmtime()
time.struct_time(tm_year=2016, tm_mon=9, tm_mday=9, tm_hour=2, tm_min=13, tm_sec=10, tm_wday=4, tm_yday=253, tm_isdst=0)
>>> time.gmtime(time.time())
time.struct_time(tm_year=2016, tm_mon=9, tm_mday=9, tm_hour=2, tm_min=15, tm_sec=35, tm_wday=4, tm_yday=253, tm_isdst=0)
>>> time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
'2016-09-09 10:54:21'
>>> time.strptime(time.ctime())
time.struct_time(tm_year=2016, tm_mon=9, tm_mday=9, tm_hour=11, tm_min=0, tm_sec=4, tm_wday=4, tm_yday=253, tm_isdst=-1)

struct_time共有9个元素，其中前面6个为年月日时分秒，后面三个分别代表的含义为：

tm_wday 一周的第几天（周日是0）
tm_yday 一年的第几天
tm_isdst 是否是夏令时

温馨提示： time模块常用函数只有time.sleep()、time.time()、time.strftime()、time.strptime()，其中strftime和strptime也可以使用datetime模块处理更好。

datetime模块

datetime 比 time 高级了不少，可以理解为 datetime 基于 time 进行了封装，提供了更多实用的函数。

datetime模块定义了下面这几个类：

date：表示日期的类。常用的属性有year, month, day
time：表示时间的类。常用的属性有hour, minute, second, microsecond
datetime：表示日期时间
timedelta：表示时间间隔，即两个时间点之间的长度
tzinfo：与时区有关的相关信息

注：上面这些类型的对象都是不可变（immutable）的。

date类

date类定义了一些常用的类方法与类属性:

max、min：date对象所能表示的最大、最小日期
resolution：date对象表示日期的最小单位。这里是天
today()：返回一个表示当前本地日期的date对象
fromtimestamp(timestamp)：根据给定的时间戮，返回一个date对象
fromordinal(ordinal)：将Gregorian日历时间转换为date对象(特殊历法用不上)

from datetime import date
import time
print('date.max:', date.max)
print('date.min:', date.min)
print('date.resolution:', date.resolution)
print('date.today():', date.today())
print('date.fromtimestamp():', date.fromtimestamp(time.time()))

执行结果：

date.max: 9999-12-31
date.min: 0001-01-01
date.resolution: 1 day, 0:00:00
date.today(): 2016-09-12
date.fromtimestamp(): 2016-09-12

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类似。
.toordinal()：返回日期对应的Gregorian Calendar日期

from datetime import date
today = date.today()
print('today:', today)
print('.year:', today.year)
print('.month:', today.month)
print('.replace():', today.replace(year=2017) )
print('.weekday():', today.weekday())
print('.isoweekday():', today.isoweekday())
print('.isocalendar():', today.isocalendar())
print('.isoformat():', today.isoformat())
print('.strftime():', today.strftime('%Y-%m-%d') )
print('.toordinal():', today.toordinal())

执行结果：

today: 2016-09-12
.year: 2016
.month: 9
.replace(): 2017-09-12
.weekday(): 0
.isoweekday(): 1
.isocalendar(): (2016, 37, 1)
.isoformat(): 2016-09-12
.strftime(): 2016-09-12
.toordinal(): 736219

date还对某些操作进行了重载，它允许我们对日期进行如下一些操作：

date2 = date1 + timedelta # 日期加上一个间隔，返回一个新的日期对象
date2 = date1 – timedelta # 日期减去一个间隔，返回一个新的日期对象
timedelta = date1 – date2 # 两个日期相减，返回一个时间间隔对象
date1 < date2 # 两个日期进行比较

time类

time类的构造函数如下：（其中参数tzinfo，它表示时区信息。）

class datetime.time(hour[, minute[, second[, microsecond[, tzinfo]]]])

time类定义的类属性：

min、max：time类所能表示的最小、最大时间。其中，time.min = time(0, 0, 0, 0)， time.max = time(23, 59, 59, 999999)
resolution：时间的最小单位，这里是1微秒

time类提供的实例方法和属性：

.hour、.minute、.second、.microsecond：时、分、秒、微秒
.tzinfo：时区信息
.replace([hour[, minute[, second[, microsecond[, tzinfo]]]]])：创建一个新的时间对象，用参数指定的时、分、秒、微秒代替原有对象中的属性（原有对象仍保持不变）；
.isoformat()：返回型如”HH:MM:SS”格式的字符串表示；
.strftime(fmt)：返回自定义格式化字符串。

像date一样，也可以对两个time对象进行比较，或者相减返回一个时间间隔对象。这里就不提供例子了。

datetime类

datetime是date与time的结合体，包括date与time的所有信息。它的构造函数如下：datetime.datetime(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])，各参数的含义与date、time的构造函数中的一样，要注意参数值的范围。

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对象；

from datetime import datetime
import time
print('datetime.max:', datetime.max)
print('datetime.min:', datetime.min)
print('datetime.resolution:', datetime.resolution)
print('today():', datetime.today())
print('now():', datetime.now())
print('utcnow():', datetime.utcnow())
print('fromtimestamp(tmstmp):', datetime.fromtimestamp(time.time()))
print('utcfromtimestamp(tmstmp):', datetime.utcfromtimestamp(time.time()))

运行结果：

datetime.max: 9999-12-31 23:59:59.999999
datetime.min: 0001-01-01 00:00:00
datetime.resolution: 0:00:00.000001
today(): 2016-09-12 19:57:00.761000
now(): 2016-09-12 19:57:00.761000
utcnow(): 2016-09-12 11:57:00.761000
fromtimestamp(tmstmp): 2016-09-12 19:57:00.761000
utcfromtimestamp(tmstmp): 2016-09-12 11:57:00.761000

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格式字符串，等效于ctime(time.mktime(dt.timetuple()))；
strftime(format)

像date一样，也可以对两个datetime对象进行比较，或者相减返回一个时间间隔对象，或者日期时间加上一个间隔返回一个新的日期时间对象。

timedelta类

通过timedelta函数返回一个timedelta对象，也就是一个表示时间间隔的对象。函数参数情况如下所示:

class datetime.timedelta([days[, seconds[, microseconds[, milliseconds[, minutes[, hours[, weeks]]]]]]])

其没有必填参数，简单控制的话第一个整数就是多少天的间隔的意思:

datetime.timedelta(10)

两个时间间隔对象可以彼此之间相加或相减，返回的仍是一个时间间隔对象。而更方便的是一个datetime对象如果减去一个时间间隔对象，那么返回的对应减去之后的datetime对象，然后两个datetime对象如果相减返回的是一个时间间隔对象。这很是方便。

tzinfo类

tzinfo是一个抽象类，不能被直接实例化。需要派生子类，提供相应的标准方法。datetime模块并不提供tzinfo的任何子类。最简单的方式是使用pytz模块。

格式化时间函数strftime的格式符详解

格式符	说明
%a	星期的英文单词的缩写：如星期一，则返回 Mon
%A	星期的英文单词的全拼：如星期一，返回 Monday
%b	月份的英文单词的缩写：如一月，则返回 Jan
%B	月份的引文单词的缩写：如一月，则返回 January
%c	返回datetime的字符串表示，如03/08/15 23:01:26
%d	返回的是当前时间是当前月的第几天
%f	微秒的表示：范围: [0,999999]
%H	以24小时制表示当前小时
%I	以12小时制表示当前小时
%j	返回当天是当年的第几天范围[001,366]
%m	返回月份范围[0,12]
%M	返回分钟数范围 [0,59]
%P	返回是上午还是下午–AM or PM
%S	返回秒数范围 [0,61]。。。手册说明的
%U	返回当周是当年的第几周以周日为第一天
%W	返回当周是当年的第几周以周一为第一天
%w	当天在当周的天数，范围为[0, 6]，6表示星期天
%x	日期的字符串表示：03/08/15
%X	时间的字符串表示：23:22:08
%y	两个数字表示的年份 15
%Y	四个数字表示的年份 2015
%z	与utc时间的间隔（如果是本地时间，返回空字符串）
%Z	时区名称（如果是本地时间，返回空字符串）

pytz模块

pytz是Python的一个时区处理模块（同时也包括夏令时），在理解时区处理模块之前，需要先要了解一些时区的概念。

要知道时区之间的转换关系，其实这很简单：把当地时间减去当地时区，剩下的就是格林威治时间了。例如北京时间的18:00就是18:00+08:00，相减以后就是10:00+00:00，因此就是格林威治时间的10:00。

Python的datetime可以处理2种类型的时间，分别为offset-naive和offset-aware。前者是指没有包含时区信息的时间，后者是指包含时区信息的时间，只有同类型的时间才能进行减法运算和比较。

datetime模块的函数在默认情况下都只生成offset-naive类型的datetime对象，例如now()、utcnow()、fromtimestamp()、utcfromtimestamp()和strftime()。其中now()和fromtimestamp()可以接受一个tzinfo对象来生成offset-aware类型的datetime对象，但是标准库并不提供任何已实现的tzinfo类，只能自己实现。

下面就是实现格林威治时间和北京时间的tzinfo类的例子：

ZERO_TIME_DELTA = timedelta(0)
LOCAL_TIME_DELTA = timedelta(hours=8) # 本地时区偏差
class UTC(tzinfo):
    def utcoffset(self, dt):
        return ZERO_TIME_DELTA
    def dst(self, dt):
        return ZERO_TIME_DELTA
class LocalTimezone(tzinfo):
    def utcoffset(self, dt):
        return LOCAL_TIME_DELTA
    def dst(self, dt):
        return ZERO_TIME_DELTA
    def tzname(self, dt):
        return '+08:00'

一个tzinfo类需要实现utcoffset、dst和tzname这3个方法。其中utcoffset需要返回夏时令的时差调整；tzname需要返回时区名，如果你不需要用到的话，也可以不实现。

一旦生成了一个offset-aware类型的datetime对象，我们就能调用它的astimezone()方法，生成其他时区的时间（会根据时差来计算）。而如果拿到的是offset-naive类型的datetime对象，也是可以调用它的replace()方法来替换tzinfo的，只不过这种替换不会根据时差来调整其他时间属性。因此，如果拿到一个格林威治时间的offset-naive类型的datetime对象，直接调用replace(tzinfo=UTC())即可转换成offset-aware类型，然后再调用astimezone()生成其他时区的datetime对象。

看上去一切都很简单，但不知道你还是否记得上文所述的夏时令。提起夏时令这个玩意，真是让我头疼，因为它没有规则可循：有的国家实行夏时令，有的国家不实行，有的国家只在部分地区实行夏时令，有的地区只在某些年实行夏时令，每个地区实行夏时令的起止时间都不一定相同，而且有的地方TMD还不是用几月几日来指定夏时令的起止时间的，而是用某月的第几个星期几这种形式。

pytz模块，使用Olson TZ Database解决了跨平台的时区计算一致性问题，解决了夏令时带来的计算问题。由于国家和地区可以自己选择时区以及是否使用夏令时，所以pytz模块在有需要的情况下得更新自己的时区以及夏令时相关的信息。

pytz提供了全部的timezone信息，如：

import pytz
print(len(pytz.all_timezones))
print(len(pytz.common_timezones))

运行结果：

588
436

如果需要获取某个国家的时区，可以使用如下方式：

import pytz
print(pytz.country_timezones('cn'))

执行结果：

[u'Asia/Shanghai', u'Asia/Urumqi']

中国一个有两个时区，一个为上海，一个为乌鲁木齐，我们来看下我们有什么区别：

from datetime import datetime
import pytz
print(pytz.country_timezones('cn'))
tz1 = pytz.timezone(pytz.country_timezones('cn')[0])
print(tz1)
print(datetime.now(tz1))
tz2 = pytz.timezone(pytz.country_timezones('cn')[1])
print(tz2)
print(datetime.now(tz2))

执行结果：

[u'Asia/Shanghai', u'Asia/Urumqi']
Asia/Shanghai
2016-09-14 09:55:39.384000+08:00
Asia/Urumqi
2016-09-14 07:55:39.385000+06:00

可以看到上海是东八区，而乌鲁木齐是东六区。

时区转换

操作起来有而比较简单，本地时区与UTC的互转：

from datetime import datetime
import pytz
now = datetime.now()
tz = pytz.timezone('Asia/Shanghai')
print(tz.localize(now))
print(pytz.utc.normalize(tz.localize(now)))

执行结果：

2016-09-14 10:25:44.633000+08:00
2016-09-14 02:25:44.633000+00:00

使用astimezone()可以进行时区与时区之间的转换。

from datetime import datetime
import pytz
utc = pytz.utc
beijing_time = pytz.timezone('Asia/Shanghai')
japan_time = pytz.timezone('Asia/Tokyo')
now = datetime.now(beijing_time)
print("Beijing Time:",now)
print("UTC:",now.astimezone(utc))
print("JAPAN TIME:",now.astimezone(japan_time))

执行结果：

Beijing Time: 2016-09-14 10:19:22.671000+08:00
UTC: 2016-09-14 02:19:22.671000+00:00
JAPAN TIME: 2016-09-14 11:19:22.671000+09:00

另外可以采用 replace来修改时区，时区多出6分钟（不要使用）。具体原因为：

民國17年（1928年），國民政府統一中國，原中央觀象台的業務由南京政府中央研究院的天文研究所和氣象研究所分別接收。天文研究所編寫的曆書基本上沿襲中央觀象台的做法，仍將全國劃分為5個標準時區，只是在有關交氣、合朔、太陽出沒時刻等處，不再使用北平的地方平時，而改以南京所在的標準時區的區時即東經120°標準時替代。從北平地方平時改為東經120°標準時，兩者相差了352秒。

from datetime import datetime
import pytz
now = datetime.now()
print(now)
tz = pytz.timezone('Asia/Shanghai')
print(now.replace(tzinfo=tz))

执行结果：

2016-09-14 10:29:20.200000
2016-09-14 10:29:20.200000+08:06

夏令时处理

由于用到的场景比较少，不做细化学习。

dateutil模块

安装模块：pip install Python-dateutil

parser.parse()

解析时间到datetime格式，支持大部分时间字符串。没指定时间默认是0点，没指定日期默认是今天，没指定年份默认是今年。

from dateutil import parser
print(parser.parse("8th March,2004"))
print(parser.parse("8 March,2004"))
print(parser.parse("March 8th,2004"))
print(parser.parse("March 8,2004"))
print(parser.parse("2016-09-14"))
print(parser.parse("20160914"))
print(parser.parse("2016/09/14"))
print(parser.parse("09/14/2016"))
print(parser.parse("09,14"))
print(parser.parse("12:00:00"))
print(parser.parse("Wed, Nov 12"))

执行结果：

2004-03-08 00:00:00
2004-03-08 00:00:00
2004-03-08 00:00:00
2004-03-08 00:00:00
2016-09-14 00:00:00
2016-09-14 00:00:00
2016-09-14 00:00:00
2016-09-14 00:00:00
2016-09-09 00:00:00
2016-09-14 12:00:00
2016-11-12 00:00:00

*relativedelta.relativedelta()

**分析：**如果使用datetime模块中的timedelta函数，不支持年月，遇到1、3、5、7这些特殊的月份呢？直接使用days=30? 还有一个更加特殊的2月份呢？还有考虑平闰年问题呢？怎么解决呢？或许可以能解决，但是会发现麻烦很多。所以用relativedelta函数是最优解！

下面是relativedelta最常见的参数：

years：年份差异。
months：月份差异。
weeks：星期差异。
days：日差异。
hours：小时差异。
minutes：分钟差异。
seconds：秒差异。
microseconds：微秒差异。
leapdays：是否包括闰年。True表示包括，False表示不包括。默认为False。

# 1. 计算日期偏移

from dateutil import rrule
from dateutil.relativedelta import relativedelta
from datetime import datetime
# 假设当前日期为2021年9月1日，缴费日期为6月1日
today = datetime(2021, 9, 1)
pay_time = datetime(2021, 6, 1)

# 计算服务费截止日期
service_fee_due_date = pay_time + relativedelta(years=1)

print(f"User's service fee due date is: {service_fee_due_date.date()}")

# 计算3个月前的日期
three_months_ago = today - relativedelta(months=3)

# 计算5天后的日期
five_days_later = today + relativedelta(days=5)

print("Three months ago was:", three_months_ago)
print("Five days later will be:", five_days_later)


# 2. 计算两个日期之间的天数、月数、年数

from datetime import datetime
from dateutil.relativedelta import relativedelta

# 2022年3月1日和2021年9月1日之间的日期差
d1 = datetime(2022, 3, 1)
d2 = datetime(2021, 9, 1)

delta = relativedelta(d1, d2)

# 输出日期差
print(f"Days between the two dates: {delta.days}")
print(f"Months between the two dates: {delta.months}")
print(f"Years between the two dates: {delta.years}")

# 3. 计算上周和这个月的第一天

from datetime import datetime
from dateutil.relativedelta import relativedelta, FR
# 上周的开始日期
last_week = datetime.now() - relativedelta(weeks=1)
last_week_start = last_week - relativedelta(weekday=FR)
print(f"Last week's start date is: {last_week_start.date()}")

# 这个月的第一天
this_month_start = datetime.now().replace(day=1)
print(f"This month's start date is: {this_month_start.date()}")

rrule.rrule()

函数主要功能：按照规则生成日期和时间。函数原型如下。

rrule(self, freq, dtstart=None, interval=1, wkst=None, count=None, until=None, bysetpos=None, bymonth=None, bymonthday=None, byyearday=None, byeaster=None, byweekno=None, byweekday=None, byhour=None, byminute=None, bysecond=None, cache=False)

其中：

freq:可以理解为单位。可以是 YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, SECONDLY。即年月日周时分秒。
dtstart,until:是开始和结束时间。
wkst:周开始时间。
interval:间隔。
count:指定生成多少个。
byxxx:指定匹配的周期。比如byweekday=(MO,TU)则只有周一周二的匹配。byweekday可以指定MO,TU,WE,TH,FR,SA,SU。即周一到周日。

更多参考：http://dateutil.readthedocs.io/en/stable/index.html

Arrow

reference：Python - Arrow更好的日期和时间处理库 - 知乎

arrow底层就是导入了calendar、datetime、time、dateutil时间处理库

Arrow 提供了一个友好而且非常易懂的方法，用于创建时间、计算时间、格式化时间，还可以对时间做转化、提取、兼容 python datetime 类型。它包括dateutil模块，根据其文档描述Arrow旨在“帮助你使用更少的代码来处理日期和时间”。

UTC 时间

使用utcnow()功能创建 UTC 时间。

使用to()方法，我们将 UTC 时间转换为本地时间。

import arrow
utc = arrow.utcnow()
print(utc)
print(utc.to('local'))

当地时间

本地时间是特定区域或时区中的时间。

import arrow
now = arrow.now()
print(now)
print(now.to('UTC'))

使用now()功能创建本地时间。to()方法用于将本地时间转换为 UTC 时间。

解析时间

get()方法用于解析时间。

import arrow
d1 = arrow.get('2012-06-05 16:20:03', 'YYYY-MM-DD HH:mm:ss')
print(d1)
d2 = arrow.get(1504384602)
print(d2)

该示例从日期和时间字符串以及时间戳解析时间。

Unix 时间戳

import arrow
utc = arrow.utcnow()
print(utc)
unix_time = utc.timestamp
print(unix_time)
date = arrow.Arrow.fromtimestamp(unix_time)
print(date)

该示例显示本地时间和 Unix 时间。然后，它将 Unix 时间转换回 date 对象。

使用fromtimestamp()方法，我们将 Unix 时间转换回 Arrow 日期对象。

也可以将日期格式化为 Unix 时间。

import arrow
utc = arrow.utcnow()
print(utc.format('X'))

通过将’X’说明符传递给format()方法，我们将当前本地日期打印为 Unix 时间。

格式化日期和时间

日期和时间可以用format()方法格式化。

import arrow
now = arrow.now()
year = now.format('YYYY')
print("Year: {0}".format(year))
date = now.format('YYYY-MM-DD')
print("Date: {0}".format(date))
date_time = now.format('YYYY-MM-DD HH:mm:ss')
print("Date and time: {0}".format(date_time))
date_time_zone = now.format('YYYY-MM-DD HH:mm:ss ZZ')
print("Date and time and zone: {0}".format(date_time_zone))

格式说明：

转换为区域时间

import arrow
utc = arrow.utcnow()
print(utc.to('US/Pacific').format('HH:mm:ss'))
print(utc.to('Europe/Bratislava').format('HH:mm:ss'))
print(utc.to('Europe/Moscow').format('HH:mm:ss'))

工作日

可以使用weekday()或format()方法找到日期的工作日。

import arrow
d1 = arrow.get('1948-12-13')
print(d1.weekday())
print(d1.format('dddd'))

移动时间

shift()方法用于移动时间。

import arrow
now = arrow.now()
print(now.shift(hours=5).time())
print(now.shift(days=5).date())
print(now.shift(years=-8).date())

夏令时

import arrow
now = arrow.now()
print(now.format("YYYY-MM-DD HH:mm:ss ZZ"))
print(now.dst())

该示例使用dst()显示夏令时。

人性化的日期和时间

在社交网站上，我们经常可以看到诸如“一个小时前”或“ 5 分钟前”之类的术语，这些术语可以为人们提供有关帖子创建或修改时间的快速信息。Arrow 包含humanize()方法来创建此类术语。

import arrow
now = arrow.now()
d1 = now.shift(minutes=-15).humanize()
print(d1)
d2 = now.shift(hours=5).humanize()
print(d2)

ISO 8601类

国际标准ISO 8601，是国际标准化组织的日期和时间的表示方法，全称为《数据存储和交换形式·信息交换·日期和时间的表示方法》，在API接口开发中涉及的比较多。

>>> import dateutil.parser
>>> dateutil.parser.parse('2008-09-03T20:56:35.450686Z') # RFC 3339 format
datetime.datetime(2008, 9, 3, 20, 56, 35, 450686, tzinfo=tzutc())
>>> dateutil.parser.parse('2008-09-03T20:56:35.450686') # ISO 8601 extended format
datetime.datetime(2008, 9, 3, 20, 56, 35, 450686)
>>> dateutil.parser.parse('20080903T205635.450686') # ISO 8601 basic format
datetime.datetime(2008, 9, 3, 20, 56, 35, 450686)
>>> dateutil.parser.parse('20080903') # ISO 8601 basic format, date only
datetime.datetime(2008, 9, 3, 0, 0)

或者使用如下方式解析：

>>> datetime.datetime.strptime("2008-09-03T20:56:35.450686Z", "%Y-%m-%dT%H:%M:%S.%fZ")

另外还可以使用iso8601模块：

http://pyiso8601.readthedocs.io/en/latest/

实用案例

# -*- coding: utf-8 -*-
"""
@Time ： 2023/7/3 7:10 PM
@Auth ： niexin
"""
import time
import datetime
from dateutil import parser
from dateutil.relativedelta import relativedelta


class DateTimeUtil(object):
    TIME_FORMAT = "%Y-%m-%d %H:%M:%S"
    years = 0
    months = 0
    days = 0
    weeks = 0
    hours = 0
    minutes = 0
    seconds = 0

    @classmethod
    def str2timestamp(cls, timestr):
        """
        :param timestr: "时间格式字符串"
        时间字符串转时间戳
        """
        return int(parser.parse(timestr).timestamp())

    @classmethod
    def timestamp2str(cls, timestamp, format=""):
        """
        :param timestamp: "时间戳"
        时间戳转时间字符串
        """
        if format == "":
            format = DateTimeUtil.TIME_FORMAT
        return datetime.datetime.fromtimestamp(int(timestamp)).strftime(format)

    @classmethod
    def get_start_end_timestr(cls, opera="+", base_date="today", **kwargs):
        """ 获取开始时间和结束时间
        :param opera: "+" or "-"
        :param base_date: str类型 初始时间，可日期可时间戳
        :param kwargs: 同relativedelta的参数
        """
        base_date = str(base_date)
        if isinstance(base_date, str):
            if base_date == "today":
                base_d = datetime.datetime.now()
            elif base_date.isdigit():
                base_d = datetime.datetime.fromtimestamp(int(base_date))
            else:
                base_d = parser.parse(base_date)
        if opera == "+":
            new_datetime = base_d + relativedelta(**kwargs)
            return base_d, new_datetime
        elif opera == "-":
            new_datetime = base_d - relativedelta(**kwargs)
            return new_datetime, base_d