2019-09-10
### 一、概述 `datetimeLib` 是增强版的日期时间处理库，依赖 `re`、`time`、`datetime`、`arrow` 库。`datetimeLib` 是对 `arrow` 库进行二次封装，使用更加方便简洁，只用一行就可以解决`99%`的问题。 下面是对 `datetimeLib` 的详解，如想快速使用，请移步 `demo.py` 模块，里面有 `datetimeLib` 的快速使用示例。 ### 二、安装 `datetimeLib` 是以源码的方式呈现，使用的时候直接导入即可 from datetimeLib import dt ### 三、使用 `datetimeLib` 所有的功能都是 `dt` 的属性或方法，它们的返回值都是 `string` 类型，`datetimeLib` 包括 `7` 类功能。 1. 返回当前日期或时间的属性 2. 返回当前日期或时间的方法 3. 日期时间和时间戳相互转换 4. 移动日期和时间 5. 一个时间段内的连续日期列表 6. 格式转换 7. 休眠 #### 1. 返回当前日期或时间的属性 返回年 dt.year 返回月 dt.month 返回日 dt.day 返回小时 dt.hour 返回分钟 dt.minute 返回秒 dt.second 返回日期 dt.date 返回时间 dt.time 返回日期和时间 dt.datetime 返回无格式日期 dt.dt #### 2. 返回当前日期或时间的方法 其实在日常开发中，有上面返回当前日期或时间的属性已经足够用了，而且属性使用简单、方便。但是由于在某些开发的场景，需要用到 `SQLAlchemy` 来构建 `ORM`，在 `SQLAlchemy` 中，日期或时间的属性会有问题。例如，数据新增时间是数据创建的那个时间，但如果用了属性，数据新增时间却是项目启动的时间。所以为了使用 `SQLAlchemy`，加了一组返回的方法。因为目前只给 `SQLAlchemy` 来构建 `ORM`，所以命名就在所有的属性后面加上 `*_orm()`。 返回年 dt.year_orm() 返回月 dt.month_orm() 返回日 dt.day_orm() 返回小时 dt.hour_orm() 返回分钟 dt.minute_orm() 返回秒 dt.second_orm() 返回日期 dt.date_orm() 返回时间 dt.time_orm() 返回日期和时间 dt.datetime_orm() 返回无格式日期 dt.dt_orm() #### 3. 日期时间和时间戳相互转换 返回当前时间戳 dt.timestamp 日期时间转时间戳 dt.dt2ts(sdt) 参数 `sdt` 是必要参数，格式为：`'0000-00-00'` 或 `'0000-00-00 00:00:00'` 时间戳转日期时间 dt.ts2dt(sts) 参数 `sts` 是必要参数，格式为：时间戳字符串 #### 4. 移动日期和时间 dt.move_dt() 方法原型： move_dt(sdt=None, stp=None, year=0, month=0, day=0, hour=0, minute=0, second=0, week=0) 方法中有 `9` 个参数，其中两个功能参数 `sdt`、`stp`，其他都是针对时间和日期的操作，默认为 `0`，为 `0` 是默认为今天的日期和时间，传入正数是向后移动，如：`day=2`，向后移动 `2` 天（后天），传入负数是向前移动，如：`month=-1`，向前移动 `1` 个月（上月） - `sdt`：`set datetime`，即传入日期时间，格式为：`'0000-00-00'` 或 `'0000-00-00 00:00:00'`，默认为当前日期时间 - `stp`：`set timestamp`，即设置返回日期时间类型，支持 `3` 中类型：`date`、`time`、`datetime`，默认为 `date` - `year`：年 - `month`：月 - `day`：日 - `hour`：时 - `minute`：分 - `second`：秒 - `week`：周 #### 5. 一个时间段内的连续日期列表 dt.list_dt() 例如输入：`'2019-09-06'` 和 `'2019-09-08'` 输出则为：`['2019-09-06', '2019-09-07', '2019-09-08']` 方法原型： list_dt(sdate=None, edate=None) - `sdate` 开始时间，格式为：`'0000-00-00'` - `edate` 结束时间，格式为：`'0000-00-00'` #### 6. 格式转换 只针对最常用的 `'0000-00-00'` 和 `'00000000'` 格式相互转换，其他特殊格式根据所提供的功能全都可以灵活实现 dt.format_dt(sdt) 参数 `sdt` 是必要参数，传入格式为 `'0000-00-00'` 或 `'00000000'`，类型为字符串型，如果格式错误将返回 `None` #### 7. 休眠 dt.sleep(sp=0) `dt.sleep()` 是休眠时常，单位是秒，需要休眠是直接传入对应的秒数即可 dt.sleep(3) # 休眠 3 秒