timeswitch 1.0.1

Timeswitch 允许根据时间范围测试日期，以查看它们是否包含在时间范围内。时间范围使用支持绝对日期和时间、重复句点、大于、小于、介于和精确匹配比较以及括号和中缀符号逻辑运算符的组合的简单语法表示。

时间由以下有序组件组成，省略时组件具有合理的默认值：

• 年份：范围表达式，值为 1-9999

• 月份：整数值 1-12 或不区分大小写的范围表达式 jan、feb、mar、apr、may、jun、jul、aug、sep、oct、nov、dec

• 日：整数值 1-31 或不区分大小写的范围表达式 mon、tue、wed、thu、fri、sat、sun。当与一个月一起使用时，工作日有一个可选的序数 1st、2nd、3rd、4th 或 5th 前缀来表示该月的第 n 个工作日

• 小时-分钟：范围表达式，两个整数值用冒号分隔 0-23:0-59

• 复合：具有年月日时分值的全部或部分非模糊序列的范围表达式

如有必要，可以使用 API 覆盖预期的月份、工作日和序号字符串。

时间范围表达式类似于 Python 数组语法：

• -是任何值

• x是一个值 = x

• xy是值 x ≤ 值 ≤ y。注意：

  • -两边的表达式必须指定相同的最右边元素，例如2017 jan - feb而不是 2017 jan - feb 12

  • 右侧的重复周期必须与第一个相同或更频繁，例如 1月 - 2017 年 2 月无效

  • 对于工作日范围，星期一被视为一周的开始

• -x是小于或等于 x 的值

• x-是大于或等于 x 的值

时间范围表达式可以使用and、or、not 和( )组合以形成嵌套表达式。

空字符串始终处于关闭状态。破折号始终开启：

-

从 2017 年 4 月 3 日凌晨 1:30 开始始终开启：

2017 年 4 月 3 日 1:30 -

总是在 2017 年 4 月 3 日或之后的每个星期五（年份和月份可以省略，因为 'fri' 明确表示工作日）：

周五和 2017 年 4 月 3 日 -

始终在 2017 年 4 月 3 日或之后每月的第一个星期五：

2017 年 4 月 3 日和第 1 周五 -

始终在 2017 年 4 月 3 日或之后每月的第一个或第三个星期五：

（第 1 个星期五或第 3 个星期五）和 2017 年 4 月 3 日 -

每月第一个星期五下午 6:30 至晚上 9:50：

第一个周五18:30-21:50

感恩节、圣诞节、节礼日和元旦：

11 月 4 日 星期四 或 12 月 25 日 或 12 月 26 日 或 1 月 1 日

正常运算符优先级不是,和, or。括号可以用来改变这个：

不是（（ 6 月或 8 月）和 2017 年）

$ timeswitch
usage: timeswitch [-h] [-d] [-w] [-y] [-a] [-p] expression [date]
timeswitch: error: too few arguments
$ timeswitch "2017 jan 20 -"
on
$ echo $?
0
$ timeswitch "1972 dec 5 - 1975 nov 11"
off
$ echo $?
1
$

from timeswitch import timeswitch
from datetime import datetime

ts = timeswitch('2017 may 4 20:20 - 20:30')
print ts(datetime(2017, 5, 4, 20, 21))  # True
print ts(datetime(2017, 5, 4, 20, 31))  # False

ts = timeswitch('first wed', ordinals='first second third fourth fifth'.split(' '))

git clone https://bitbucket.org/rocketboots/timeswitch.git
cd timeswitch
pip install -e .[test]
python setup.py nosetests

brew install pandoc
pip install pypandoc twine
python setup.py sdist
twine register dist/timeswitch-*.tar.gz