Advanced Python Scheduler(APScheduler)是一个Python库,可让Python代码稍后执行,一次或定期执行。
用于调度和管理定时任务,它支持多种任务调度器,如基于日期、时间间隔和Cron表达式等。
如果您将作业存储在数据库中,那么调度程序重启后它们也将存活下来并保持其状态。
当调度器重新启动时,它将运行它在离线时应该运行的所有作业,APScheduler文档https://link.zhihu.com/?target=https%3A//apscheduler.readthedocs.io/en/latest/index.html。
在终端中运行命令pip install apscheduler
来安装APScheduler库。
pip install apscheduler
apscheduler 四个组件:
triggers 3种触发方式
job stores 支持四种任务存储方式
schedulers
调度器主要分三种,一种独立运行的,一种是后台运行的,最后一种是配合其它程序使用
Flask-APScheduler 中默认使用的就是 BackgroundScheduler
triggers支持三种任务触发方式
date:固定日期触发器,任务只运行一次,运行完毕自动清除;若错过指定运行时间,任务不会被创建
使用示例
scheduler.add_job(start_system, 'date', run_date='2019-4-24 00:00:01', args=['text'])
interval 时间间隔触发器,每个一定时间间隔执行一次。
参数 | 说明 |
---|---|
weeks (int) | 间隔几周 |
days (int) | 间隔几天 |
hours (int) | 间隔几小时 |
minutes (int) | 间隔几分钟 |
seconds (int) | 间隔多少秒 |
start_date (datetime 或 str) | 开始日期 |
end_date (datetime 或 str) | 结束日期 |
使用示例
scheduler .add_job(alarm_job, 'interval', hours=2, start_date='2019-4-24 00:00:00' , end_date='2019-4-24 08:00:00')
cron 定时任务触发
参数 | 说明 |
---|---|
year (int 或 str) | 表示四位数的年份 (2019) |
month(int\ str) | 月 (范围1-12) 可以是int类型,也可以是str类型 |
day(int\ str) | 日 (范围1-31) |
week(int\ str) | 周 (范围1-53) |
day_of_week (int\ str) | 表示一周中的第几天,既可以用0-6表示也可以用其英语缩写表示 |
hour (int\ str) | 表示取值范围为0-23时 |
minute (int\ str) | 表示取值范围为0-59分 |
second (int\ str) | 表示取值范围为0-59秒 |
start_date (datetime\ str) | 表示开始时间 可以是datetime类型,也可以是str类型 |
end_date (datetime\ str) | 表示结束时间 |
timezone (datetime.tzinfo\ str) | 表示时区取值 |
表示每 10 秒执行该程序一次,相当于interval 间隔调度中seconds = 10
sched.add_job(my_job, 'cron', second = '*/10')