sandglass(沙漏)——一个让人解脱的python时间处理库

Posted 2020-09-29 jzdwajue

在游戏开发的过程中频繁的须要跟时间相关的做处理。而python内置了好多个时间处理库，datetime/date/time/calendar/timedelta等，细节繁多略具迷惑性。非常多东西不够便捷直接。
想一下以下这些场景：

• 2014年六一儿童节那天的时间戳是多少？
• 2014年六一儿童节那天是星期几？
• datetime对象转成字符串后面往往带小数点，即微秒。而我存到数据库是不须要微秒的，怎么搞？
• 从配置中读取、网络中传输、数据库存储获取到的时间信息是字符串的，怎么转成能够用于运算的对象？
• 要知道近期7天的留存。怎么得到近期7天的日期？
• 測试中常常须要改系统时间，可是改系统时间这段时间内假设做其他操作会受影响，比方改动文件会导致文件的时间受影响，提交代码时间也乱套。怎么解决？
• 这个月有几天？
• 去年的今天？昨日的这个时候？2小时后？
• ...

遇到这些场景，用python内置函数的话基本上都要对着官方文档查，或者google或者stackoverflow一番。datetime、date、timestamp、时间字符串之间的互相转换可够头痛的了， ‘%Y-%m-%d %H:%M:%S‘之类的满屏幕乱飘。

在这种情况下，sandglass库诞生了。解脱了，主要函数就2个。ben()和tslice()。库的核心是Sandglass对象。当中Sandglass的意思是“沙漏”。ben是“大本钟”。用python的基本都知道python的切片非常灵活。tslice就是类似这种一个东西用来生产时间序列。
通过ben()，能够高速的通过各种时间信息获得Sandglass对象，而通过Sandglass对象。 能够获取各种信息和操作。
Sandglass对象相当于一个中转站。使得各种转换变得简单。

这样的理念有点类似转码。各种编码->unicode->各种编码。unicode就是中转站。
好了，以下演示一下用sandglass库怎么解决上面那些需求。

>>>from sandglass import ben,tslice,Sandglass
#2014年六一儿童节那天的时间戳是多少？
>>>ben(‘2014-06-01‘).timestamp
#2014年六一儿童节那天是星期几？
>>>ben(‘2014-06-01‘).isoweekday
#datetime对象转成字符串后面往往带小数点。即微秒，而我存到数据库是不须要微秒的，怎么搞？
>>>now = ben()
>>>now.sql
#从配置中读取、网络中传输、数据库存储获取到的时间信息是字符串的。怎么转成能够用于运算的对象？
>>>ben(1399387043.898),ben(‘2014-02-03‘),ben(‘2014,2,3‘),ben(‘2014/2/3‘),ben(‘19:20:00‘)
#要知道近期7天的留存。怎么得到近期7天的日期？
>>>tslice(‘day‘,start=None,end=None,step=-1,count=7)
#測试中常常须要改系统时间。可是改系统时间这段时间内假设做其他操作会受影响，比方改动文件会导致文件的时间受影响，提交代码时间也乱套，怎么解决？
>>>Sandglass.mock(day=1)#把当前日期改成明天,全部ben()或者Sandglass.now()获取的时间都受影响
#这个月有几天？
>>>ben().days_in_month
#去年的今天？昨日的这个时候？2小时后？
>>>ben().shift(year=-1),ben().shift(day=-1),ben().shift(hour=2)

很多其它详情请点击 项目 地址。