公众号:战渣渣
APScheduler库基础学习
APScheduler组成组件
-
Triggers
触发器,有自己的任务调度逻辑,每一个job单位都有触发器决定下一次何时运行。除了初始化的配置,他没有状态。
-
Job stores
储存调度任务,默认job对象,是储存在内存中,也可以用其他job对象把他们储存在各种数据库中;job保存到持久化仓库时,job数据要进行序列化,当加载job时也要进行反序列化。Job不能共享调度器。
-
Executors
是job运行的处理器,通常通过提交指定调用的job到进程或者线程池处理;当job完成后,通知发出一个适当的事件调度程序。
-
Schedulers
通常一个应用只有一个调度器,schdeuler开发者不直接处理jobs stores、Executors、Triggers, 相反,调度程序提供适当的接口来处理这些;配置job stores和executors通过调度器来完成,如增加,删除和修改。
APScheduler常用调度器
-
BlockingScheduler: 当应用程序中只有调度器时使用。
-
BackgroundScheduler: 不使用任何以下框架(asyncio、gevent、Tornado、Twisted、Qt),并且需要在你的应用程序后台运行调度程序
-
AsyncIOScheduler: 应用程序使用asyncio模块时使用
-
GeventScheduler: 应用程序使用gevent模块时使用
-
TornadoScheduler: Tornado应用程序时使用
-
TwistedScheduler: Twisted应用程序使用
-
QtScheduler: Qt应用程序时使用
APScheduler触发器
-
DateTrigger——日期触发器
添加此类触发器job之后,只运行一次,可以指定运行时间;若不指定则默认为当前时间。
正常使用时,使用add_job,不指定trigger类型,默认就是DateTrigger
指定trigger类型,可以使用字符串date,或者直接使用类DateTrigger的实例
# 示例代码
from apscheduler.triggers.date import DateTrigger
# 使用字符串方式1
scheduler.add_job(date_tick)
# 使用字符串方式2
scheduler.add_job(date_tick, 'date')
# 使用DateTrigger指定时间运行:
date = DateTrigger(datetime.now()+dt.timedelta(seconds=120))
scheduler.add_job(date_tick, date)
-
IntervalTrigger——间隔触发器
此触发器,可以指定开始时间start_date,结束时间end_date,以及间隔时间,
间隔时间可以有weeks/days/hours/minutes/seconds组成,
开始时间之后,每隔多少interval执行一次任务,直至结束时间,如果不指定结束时间,则一直执行
指定此类触发器类型,可以使用字符串interval,也可以使用类IntervalTrigger的实例对象
# 示例代码
from apscheduler.triggers.interval import IngervalTrigger
# 使用字符串方式
scheduler.add_job(interval_tick,'interval',seconds=4,minutes=2,
start_date=datetime.now()+dt.timedelta(seconds=120),
end_date=datetime.now()+dt.timedelta(seconds=360))
# 使用IntervalTrigger指定时间运行
trigger = IntervalTrigger(seconds=60,
start_date=datetime.now()+dt.timedelta(seconds=60),
end_date=datetime.now() + dt.timedelta(seconds=120))
scheduler.add_job(date_tick, trigger)
-
CronTrigger——Cron触发器
类Unix系统中的Cron中,可以任意配置指定,年月日时分秒,周,每周几定时处理任务
由表达式(Expression)和字段(Field)组成,可以根据每个字段的表达式获取执行值,由调度器获取具体的执行日期
year’: ‘’, ‘month’: 1, ‘day’: 1, ‘week’: '’, ‘day_of_week’: ‘*’, ‘hour’: 0, ‘minute’: 0, ‘second’: 0
指定具体值,或者每分钟,或者每几分钟,或者每周几等当时
year (int|str) – 4-digit year
month (int|str) – month (1-12)
day (int|str) – day of the (1-31)
week (int|str) – ISO week (1-53)
day_of_week (int|str) – number or name of weekday (0-6 or mon,tue,wed,thu,fri,sat,sun)
hour (int|str) – hour (0-23)
minute (int|str) – minute (0-59)
second (int|str) – second (0-59)
start_date (datetime|str) – earliest possible date/time to trigger on (inclusive)
end_date (datetime|str) – latest possible date/time to trigger on (inclusive)
timezone (datetime.tzinfo|str) – time zone to use for the date/time calculations (defaults to scheduler timezone)
Expression | Field | Description |
---|---|---|
* | any | Fire on every value |
*/a | any | Fire every a values, starting from the minimum |
a-b | any | Fire on any value within the a-b range (a must be smaller than b) |
a-b/c | any | Fire every c values within the a-b range |
xth y | day | Fire on the x-th occurrence of weekday y within the month |
last x | day | Fire on the last occurrence of weekday x within the month |
last | day | Fire on the last day within the month |
x,y,z | any | Fire on any matching expression; can combine any number of any of the above expressions |