[置顶] sandglass(沙漏)——一个让人解脱的python时间处理库
在游戏开发的过程中频繁的需要跟时间相关的做处理，而python内置了好多个时间处理库，datetime/date/time/calendar/timedelta等，细节繁多略具迷惑性。很多东西不够便捷直接。
想一下下面这些场景：
遇到这些场景，用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)
更多详情请点击 项目 地址。
想一下下面这些场景：
- 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)
更多详情请点击 项目 地址。