python 定时任务触发（时序模型）

APScheduler：
APScheduler 四个组件分别为：

• 调度器(scheduler)、触发器(trigger)，作业存储(job store)，执行器(executor)

安装命令：

pip install setuptools
pip install --ignore-installed apscheduler

1 新建调度器schedulers

BlockingScheduler : 调度器在当前进程的主线程中运行，也就是会阻塞当前线程
BackgroundScheduler : 调度器在后台线程中运行，不会阻塞当前线程

import datetime as dt
from apscheduler.schedulers.blocking import BlockingScheduler
scheduler = BlockingScheduler()

2 添加调度任务trigger

① date 触发器：（指定时间点触发），参数如下：

• run_date(datetime或str)：任务运行的日期或时间
• timezone(datetime.tzinfo或str)：指定时区

# 例1：在 2020-9-24 时刻运行一次 func 方法
scheduler.add_job(func, 'date', run_date = dt.date(2020, 9, 24))
# 例2： 在 2020-9-24 15:10:00 时刻运行一次 func 方法
scheduler.add_job(func, 'date', run_date = dt.datetime(2020, 9, 24, 15, 10, 0))
# 例3： 在 2020-9-24 15:11:00 时刻运行一次 func 方法
scheduler.add_job(func, 'date', run_date = '2020-9-24 15:11:00')

② interval 触发器: （固定时间间隔触发），参数如下：

•  weeks(int):间隔几周
• days(int)：间隔几天
• hours(int)：间隔几小时
• minutes(int)：间隔几分钟
• seconds(int)：间隔几秒钟
• start_date(datetime或str)：开始时间
• end_date(datetime或str)：结束时间
• timezone(datetime.tzinfo或str):时区

# 例1：每隔两分钟执行一次 func 方法
scheduler.add_job(func, 'interval', minutes = 2)
# 例2：在 2020-9-24 15:15:00 ~ 2020-9-24 15:20:00 之间, 每隔两分钟执行一次 func 方法
scheduler.add_job(func, 'interval', minutes = 2, start_date = '2020-9-24 15:15:00' , 
                  end_date = '2020-9-24 15:20:00')

③ cron 触发器：（在指定时间周期性地触发），参数如下：

• year(int 或 str)：年
• month(int 或 str)：月
• day(int 或 str)：日
• week(int 或 str)：周（1-53）
• day_of_week(int 或 str)：星期几（0-6）
• hour(int 或 str)：时
• minute(int 或 str)：分
• second(int 或 str)：秒
• start_date(datetime或str)：最早开始时间（包含）
• end_date(datetime或str)：最晚结束时间（包含）
•  timezone(datetime.tzinfo或str):指定时区

字符 :

• 1. * 每一(每一分) 
• 2. ? 表示不关心,任意 
• 3. - 范围 (小时:1-12,1到12点运行) 
• 4. , 标示多个值 (小时 1,2,3 1点2点3点运行) 
• 5. / 递增触发(0/15,从0开始每15秒运行一次) 
• 6. L 最后(日L,当月最后一天,周L周六) 
• 7. W 指定日期最近的工作日(周一到周五) 
• 8. # 序号(表示每月的第几个周几) 

# 例：在每年 1-3、7-9 月份中的每个星期一、二中的 00:00, 01:00, 02:00 和 03:00 执行 func 任务
scheduler.add_job(func, 'cron', month = '1-3,7-9',day='0, tue', hour='0-3')

3 运行调度任务

scheduler.start()

4 特点，其他操作

APScheduler 定点、定时：

四个组件分别为：触发器(trigger)，作业存储器(job store)，执行器(executor)，调度器(scheduler)

（1）job stores：对调度任务的管理：
    ① 添加job：

# add_job()：可以改变或者移除 job
scheduler.add_job(func, 'interval', minutes = 2)

# scheduled_job():只适用于应用运行期间不会改变的 job
scheduler.scheduled_job(func, 'interval', minutes = 2)

  ②移除job：

# remove_job() :根据 job 的 id 来移除，所以要在 job 创建的时候指定一个 id
scheduler.add_job(func, 'interval', minutes = 2, id = 'job_one')
scheduler.remove_job(job_one)

# job.remove() :对 job 执行 remove 方法
job = add_job(func, 'interval', minutes = 2, id = 'job_one')
job.remvoe()

     ③ 暂停job：

apscheduler.job.Job.pause()
apscheduler.schedulers.base.BaseScheduler.pause_job()

      ④ 恢复job：

apscheduler.job.Job.resume()
apscheduler.schedulers.base.BaseScheduler.resume_job()

    ⑤ 修改job：

# modify_job()
scheduler.modify_job('job_one', minutes = 5)

# job.modify()
job = scheduler.add_job(func, 'interval', minutes = 2)
job.modify(minutes = 5)

    ⑥ 关闭job：

scheduler.shutdown()
scheduler.shutdown(wait=false)

（2）executors：执行调度任务的模块，常用的 executor 有两种：
    ProcessPoolExecutor
    ThreadPoolExecutor