用于管理和操作unix epoch时间戳的实用程序库。
epoch的Python项目详细描述
============
epoch时间戳管理实用工具
==============
`epoch'提供了一组有助于管理unix epoch时间戳的例程，包括生成、调整和
分析。
project
====
*主页：https://github.com/metagriffin/epoch
*错误：https://github.com/metagriffin/epoch/issues
代码：：bash
$pip install epoch
usage
==
以下例程可用：
*``epoch.now（）`：float
返回当前unix epoch时间戳的float表示，
即自1970/01/01以来的秒数。
*``epoch.sod（[ts][，tz][，offset][，replace]）``：float
返回当前日期开始时相对于时区"tz"的纪元时间戳。如果指定了"ts"，则返回包含"ts"的一天的开始时间
。如果指定了"offset"，则将
作为整数天来抵消返回值。
请注意，由于闰秒、日光节约等原因，这比仅60秒*60分钟*24小时复杂得多。如果指定了'replace`
，则它是一个日期时间属性字典，在进行所有其他修改后将其替换。
代码：：python
epoch.sod（offset=1，tz='america/anchorage'，replace=dict（hour=15））
*``epoch.sow（[ts][，tz][，offset][，day][，replace]）`：float
返回当前公历周开始时相对于时区"tz"的epoch时间戳。如果指定了"ts"，则返回包含"ts"的周的开始
。如果指定了"offset"，则将
作为整数周数来抵消返回的
值。请注意，由于闰日、闰秒、日光
节约等原因，这比仅60秒*60分钟
*24小时*7天更为复杂。如果指定了"day"，则指定将哪个日期定义为一周的"第一"天，其中"0"是星期一到"6"是星期日。如果指定了'replace'，则它是一个日期时间属性字典，在进行所有其他修改之后（有关
示例，请参见'epoch.sod'，
*``epoch.som（[ts][，tz][，offset][，replace]）`：float
当前公历
相对于时区"tz"的月份。如果指定了"ts"，则返回包含"ts"的月份的开始
。如果指定了"offset"，则将
作为整数个月数来抵消
返回值。如果指定了'replace'，则它是一个
datetime属性字典，在所有其他修改都
完成后要替换（参见'epoch.sod'示例）。
*``epoch.soy（[ts][，tz][，offset][，replace]）`：float
相对于时区"tz"的NT gregorian
年份。如果指定了"ts"，则返回包含"ts"的年份的开始
。如果指定了"offset"，则
它将被视为整数年数，用以抵消返回的
值。如果指定了"replace"，则它是一个日期时间
属性字典，在进行所有其他修改之后要替换这些属性
（示例请参见"epoch.sod"）。
*``epoch.zulu（[ts][，ms]）`：string
返回指定的epoch time`ts`（如果没有或
未提供）作为ISO 8601组合字符串，在zulu时间内（精度
毫秒），例如"epoch.zulu（1362187446.553）"`=>；
"2013-03-02t01:24:06.553z"。如果"ms"为true（默认值），
毫秒将为包括，否则截断。如果"ts"的精度
超过毫秒，则将被截断为
毫秒级精度。
*`` epoch.parsezulu（text）``：float
将ISO 8601组合字符串解析为epoch时间戳。请注意
此函数仅限于微秒级精度（a
`datetime`系统库限制），并打算与由'epoch.zulu'生成的
字符串一起使用，因此不太可原谅。对于更人性化的解析器，请尝试：
，但请注意，它并不能正确警告歧义；
例如"01/02/03"会毫不犹豫地解释为"2003/01/02"……ugh.
*`` epoch.parse（value）`：float
尝试以下方法从
`text`提取epoch时间戳：
*检查none、integer或float类型（并返回原样）
*检查所有数字文本，并将其强制转换为float
*返回到解析via:func:`epoch.parsezulu`
请注意，此函数用于生成的代码
字符串（例如由`epoch.zulu`生成的字符串），因此
不太宽容。有关更人性化的解析器，请参见：func:`epoch.parsezulu`.
*``epoch.tsreplace（[ts][，tz][，*params]）`：float
示例：
…python
>ts=epoch.parse（'2015-12-08t114:56:33z:2015-12-08t14:12:56:33z'）
ts==1449586593.0
ts=epoch.tsreplace（ts，tz='europe/paris'，hour=9，分钟=30）
ts==1449563433.0
s=epoch.zulu（ts）
s==2015-12-08t08:30:33.000z'
*``epoch.dtreplace（dt[，*参数]```:datetime
一个版本的：meth:`datetime.datetime.replace（）`如果替换将导致dst边界
切换，则正确地
维护`dt.tzinfo`的meth:`datetime.datetime.replace（）`如果替换将导致dst边界
`` epoch.ts2age（ts[，origin][，tz]```````：float
` ` `：todo:document时代2ts（时代[，起源][，"`"：float
epoch时间戳管理实用工具
==============
`epoch'提供了一组有助于管理unix epoch时间戳的例程，包括生成、调整和
分析。
project
====
*主页：https://github.com/metagriffin/epoch
*错误：https://github.com/metagriffin/epoch/issues
代码：：bash
$pip install epoch
usage
==
以下例程可用：
*``epoch.now（）`：float
返回当前unix epoch时间戳的float表示，
即自1970/01/01以来的秒数。
*``epoch.sod（[ts][，tz][，offset][，replace]）``：float
返回当前日期开始时相对于时区"tz"的纪元时间戳。如果指定了"ts"，则返回包含"ts"的一天的开始时间
。如果指定了"offset"，则将
作为整数天来抵消返回值。
请注意，由于闰秒、日光节约等原因，这比仅60秒*60分钟*24小时复杂得多。如果指定了'replace`
，则它是一个日期时间属性字典，在进行所有其他修改后将其替换。
代码：：python
epoch.sod（offset=1，tz='america/anchorage'，replace=dict（hour=15））
*``epoch.sow（[ts][，tz][，offset][，day][，replace]）`：float
返回当前公历周开始时相对于时区"tz"的epoch时间戳。如果指定了"ts"，则返回包含"ts"的周的开始
。如果指定了"offset"，则将
作为整数周数来抵消返回的
值。请注意，由于闰日、闰秒、日光
节约等原因，这比仅60秒*60分钟
*24小时*7天更为复杂。如果指定了"day"，则指定将哪个日期定义为一周的"第一"天，其中"0"是星期一到"6"是星期日。如果指定了'replace'，则它是一个日期时间属性字典，在进行所有其他修改之后（有关
示例，请参见'epoch.sod'，
*``epoch.som（[ts][，tz][，offset][，replace]）`：float
当前公历
相对于时区"tz"的月份。如果指定了"ts"，则返回包含"ts"的月份的开始
。如果指定了"offset"，则将
作为整数个月数来抵消
返回值。如果指定了'replace'，则它是一个
datetime属性字典，在所有其他修改都
完成后要替换（参见'epoch.sod'示例）。
*``epoch.soy（[ts][，tz][，offset][，replace]）`：float
相对于时区"tz"的NT gregorian
年份。如果指定了"ts"，则返回包含"ts"的年份的开始
。如果指定了"offset"，则
它将被视为整数年数，用以抵消返回的
值。如果指定了"replace"，则它是一个日期时间
属性字典，在进行所有其他修改之后要替换这些属性
（示例请参见"epoch.sod"）。
*``epoch.zulu（[ts][，ms]）`：string
返回指定的epoch time`ts`（如果没有或
未提供）作为ISO 8601组合字符串，在zulu时间内（精度
毫秒），例如"epoch.zulu（1362187446.553）"`=>；
"2013-03-02t01:24:06.553z"。如果"ms"为true（默认值），
毫秒将为包括，否则截断。如果"ts"的精度
超过毫秒，则将被截断为
毫秒级精度。
*`` epoch.parsezulu（text）``：float
将ISO 8601组合字符串解析为epoch时间戳。请注意
此函数仅限于微秒级精度（a
`datetime`系统库限制），并打算与由'epoch.zulu'生成的
字符串一起使用，因此不太可原谅。对于更人性化的解析器，请尝试：
，但请注意，它并不能正确警告歧义；
例如"01/02/03"会毫不犹豫地解释为"2003/01/02"……ugh.
*`` epoch.parse（value）`：float
尝试以下方法从
`text`提取epoch时间戳：
*检查none、integer或float类型（并返回原样）
*检查所有数字文本，并将其强制转换为float
*返回到解析via:func:`epoch.parsezulu`
请注意，此函数用于生成的代码
字符串（例如由`epoch.zulu`生成的字符串），因此
不太宽容。有关更人性化的解析器，请参见：func:`epoch.parsezulu`.
*``epoch.tsreplace（[ts][，tz][，*params]）`：float
示例：
…python
>ts=epoch.parse（'2015-12-08t114:56:33z:2015-12-08t14:12:56:33z'）
ts==1449586593.0
ts=epoch.tsreplace（ts，tz='europe/paris'，hour=9，分钟=30）
ts==1449563433.0
s=epoch.zulu（ts）
s==2015-12-08t08:30:33.000z'
*``epoch.dtreplace（dt[，*参数]```:datetime
一个版本的：meth:`datetime.datetime.replace（）`如果替换将导致dst边界
切换，则正确地
维护`dt.tzinfo`的meth:`datetime.datetime.replace（）`如果替换将导致dst边界
`` epoch.ts2age（ts[，origin][，tz]```````：float
` ` `：todo:document时代2ts（时代[，起源][，"`"：float
欢迎加入QQ群-->： 979659372
