python arrow库详解
Python针对日期时间的处理提供了大量的package,类和方法,但在可用性上来看非常繁琐和麻烦
第三方库Arrow提供了一个合理的、人性化的方法来创建、操作、格式转换的日期,时间,和时间戳,帮助我们使用较少的导入和更少的代码来处理日期和时间。
$ pip install arrow
- 获取当前时间
arrow.utcnow()
,arrow.now()
>>> import arrow
>>> utc = arrow.utcnow() # 获取世界标准时间
>>> utc
<Arrow [2018-06-07T09:37:28.989983+00:00]>
>>> utc = arrow.now() # 获取本地时间
>>> utc
<Arrow [2018-06-07T17:40:19.019529+08:00]>
>>> arrow.now('US/Pacific') # 获取指定时区的时间
<Arrow [2018-06-07T02:41:54.815029-07:00]>
- 将时间戳转化为arrow对象
arrow.get(timestamp)
>>> arrow.get(1519534533)
<Arrow [2018-02-25T04:55:33+00:00]>
>>> arrow.get('1519534533')
<Arrow [2018-02-25T04:55:33+00:00]>
>>> arrow.get(1519534533.153443)
<Arrow [2018-02-25T04:55:33.153443+00:00]>
>>> arrow.get('1519534533.153443')
<Arrow [2018-02-25T04:55:33.153443+00:00]>
时间戳可以是int,float或者可以转化为float的字符串
- 将字符串转换为arrow对象
arrow.get(string[,format_string])
>>> arrow.get('2018-02-24 12:30:45', 'YYYY-MM-DD HH:mm:ss')
<Arrow [2018-02-24T12:30:45+00:00]>
- 遵循ISO-8601的字符串不需要格式字符串参数即可转换
>>> arrow.get('2018-02-24T13:00:00.000-07:00')
<Arrow [2018-02-24T13:00:00-07:00]>
- 可以从字符串中通过格式参数搜索时间
>>> arrow.get('June was born in May 1980', 'MMMM YYYY')
<Arrow [1980-05-01T00:00:00+00:00]>
- 直接创建arrow对象
>>> arrow.get(2018, 2, 24)
<Arrow [2018-02-24T00:00:00+00:00]>
>>> arrow.Arrow(2018, 2, 24)
<Arrow [2018-02-24T00:00:00+00:00]>
- arrow对象属性
datetime
,timestamp
,native
,tzinfo
>>> a = arrow.utcnow()
>>> a.datetime
datetime.datetime(2018, 2, 24, 21, 15, 50, 841056, tzinfo=tzlocal())
>>> a.timestamp
1519478150
>>> a.naive
datetime.datetime(2018, 2, 24, 21, 58, 4, 309575)
>>> a.tzinfo
tzlocal()
- 按名称或tzinfo转换为时区
>>> arw = arrow.utcnow()
>>> arw
<Arrow [2018-06-07T11:16:51.695083+00:00]>
>>> arw.to('US/Pacific')
<Arrow [2018-06-07T04:16:51.695083-07:00]>
- 获取datetime对象的值
>>> a = arrow.now()
>>> a
<Arrow [2018-06-07T17:44:43.519166+08:00]>
>>> a.year # 当前年
2018
>>> a.month # 当前月份
6
>>> a.day # 当前天
7
>>> a.hour # 当前第几个小时
17
>>> a.minute # 当前多少分钟
44
>>> a.second # 当前多少秒
43
>>> a.timestamp # 获取时间戳
1528364683
>>> a.float_timestamp # 浮点数时间戳
1528364683.519166
- 时间推移
a.shift(**kwargs)
shift方法获取某个时间之前或之后的时间,关键字参数为years,months,weeks,days,hours,seconds,microseconds
>>> a.shift(weeks=+3) #三周后
<Arrow [2018-03-17T21:58:04.309575+08:00]>
>>> a.shift(days=-1) #一天前
<Arrow [2018-02-23T21:58:04.309575+08:00]
>>> a.shift(weekday=6) #距离最近a的星期日,weekday从0到6
<Arrow [2018-02-25T21:58:04.309575+08:00]>
- 时间替换
a.replace(**kwargs)
返回一个被替换后的arrow对象,原对象不变
>>> a
<Arrow [2018-02-24T21:58:04.309575+08:00]>
>>> a.replace(hour=9)
<Arrow [2018-02-24T09:58:04.309575+08:00]>
- 格式化输出 a.format([format_string])
>>> a = arrow.now()
>>> a
<Arrow [2018-06-07T17:59:36.917894+08:00]>
>>> a.format()
'2018-06-07 17:59:36+08:00'
>>> a.format('YYYY-MM-DD HH:mm:ss ZZ')
'2018-06-07 17:59:36 +08:00'
>>> a.ctime() # 返回日期和时间的ctime格式化表示。
'Thu Jun 7 17:59:36 2018'
>>> a.weekday() # 以整数形式返回星期几(0-6)
3
>>> a.isoweekday() # 以整数形式返回一周中的ISO日(1-7)
4
>>> a.isocalendar() # 返回3元组(ISO年,ISO周数,ISO工作日)
(2018, 23, 4)
>>> a.toordinal() # 返回日期的格雷戈里序数
736852
- 人性化输出 a.humanize()
>>> present = arrow.utcnow()
>>> past = present.shift(hours=-1)
>>> past.humanize() #相对于当前时间
'an hour age'
>>> future = present.shift(hours=2)
>>> future.humanize(present) #相对于参数时间
'in 2 hours'
>>> past.humanize(present, locale='zh') #locale参数可以指定地区语言
'1天前'
- 时间范围和区间
a.span(string)
,a.floor()
,a.ceil()
arrow.Arrow.span_range()
,arrow.Arrow.range()
>>> a
<Arrow [2018-02-24T21:58:04.309575+08:00]>
>>> a.span('hour') #a所在的时间区间
(<Arrow [2018-02-24T21:00:00+08:00]>, <Arrow [2018-02-24T21:59:59.999999+08:00]>)
>>> a.floor('hour') #a所在区间的开始
<Arrow [2018-02-24T21:00:00+08:00]>
>>> a.ceil('hour') #a所在区间的结尾
<Arrow [2018-02-24T21:59:59.999999+08:00]
>>> start = datetime.datetime(2018, 2, 24, 12, 30)
>>> end = datetime.datetime(2018, 2, 24, 15, 20)
>>> for r in arrow.Arrow.span_range('hour',start,end): #获取start,end之间的时间区间
... print(r)
...
(<Arrow [2018-02-24T12:00:00+00:00]>, <Arrow [2018-02-24T12:59:59.999999+00:00]>)
(<Arrow [2018-02-24T13:00:00+00:00]>, <Arrow [2018-02-24T13:59:59.999999+00:00]>)
(<Arrow [2018-02-24T14:00:00+00:00]>, <Arrow [2018-02-24T14:59:59.999999+00:00]>)
(<Arrow [2018-02-24T15:00:00+00:00]>, <Arrow [2018-02-24T15:59:59.999999+00:00]>)
>>> for r in arrow.Arrow.range('hour',start,end): #获取间隔单位时间的时间
... print(r)
...
2018-02-24T12:30:00+00:00
2018-02-24T13:30:00+00:00
2018-02-24T14:30:00+00:00
格式化字符串标记