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()
3.1 测试时间
def forecast_adjust():
now_temp = datetime.now()
print('执行方案一', now_temp, '时间间隔: ', now_temp-t0)
def for2():
now_temp = datetime.now()
print('执行方案二', now_temp, '时间间隔: ', now_temp-t0)
def fortime3():
now_temp = datetime.now()
print('执行方案三', now_temp, '时间间隔: ', now_temp-t0)
return '9999999999999'
def a__():
b = scheduler.add_job(fortime3, 'cron', hour='15', minute = '18')
c = scheduler.add_job(fortime3, 'cron', hour='15', minute = '30')
d = scheduler.add_job(fortime3, 'cron', hour='15', minute = '45')
print(b)
print(c)
print(c)
return 'kkkqq'
t0 = datetime.now()
scheduler = BlockingScheduler() # 采用阻塞的方式
scheduler.add_job(func=forecast_adjust,
trigger=CronTrigger(minute="*/1", second=20,
timezone=tz_now), args=[])
scheduler.add_job(func=for2,
trigger=CronTrigger(minute="*/5", second=10,
timezone=tz_now), args=[])
k = a__()
print(k)
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
五 标准的多线程
from apscheduler.schedulers.blocking import BlockingScheduler
def job1():
print("Job 1 executed")
def job2():
print("Job 2 executed")
scheduler = BlockingScheduler()
# 添加 job1 和 job2
scheduler.add_job(job1, 'interval', minutes=1)
scheduler.add_job(job2, 'interval', minutes=2)
scheduler.start()
添加传参:args
scheduler.add_job(func=my_function, args=[arg1, arg2], trigger='interval', seconds=10)
六trigger
在apscheduler
中,trigger
用于指定作业何时被执行。trigger
可以有以下几种类型:
date
:一次性地在指定日期和时间执行作业。interval
:每隔一段时间执行一次作业,可以通过weeks
、days
、hours
、minutes
、seconds
、microseconds
参数指定时间间隔。cron
:按照指定的cron表达式执行作业。
下面是一些具体的例子:
1 date
类型:
from datetime import datetime
from apscheduler.schedulers.blocking import BlockingScheduler
def job():
print('Job started')
scheduler = BlockingScheduler()
scheduler.add_job(func=job, trigger='date', run_date=datetime(2023, 4, 15, 15, 30, 0))
scheduler.start()
上面的代码会在2023年4月15日15:30:00执行一次job
函数。
2 interval
类型:
from apscheduler.schedulers.blocking import BlockingScheduler
def job():
print('Job started')
scheduler = BlockingScheduler()
scheduler.add_job(func=job, trigger='interval', seconds=10)
scheduler.start()
上面的代码会隔10秒执行一次job
函数。
3 cron
类型:
from apscheduler.schedulers.blocking import BlockingScheduler
def job():
print('Job started')
scheduler = BlockingScheduler()
scheduler.add_job(func=job, trigger='cron', day_of_week='mon-fri', hour='8-17', minute='*/30')
scheduler.start()
上面的代码会在一周一到五的8:00到17:00之间,每间隔30分钟执行一次job
函数。
在上面的例子中,trigger
参数是用来指定job
函数的执行时间的。可以看出,根据不同的trigger
类型,job
函数的执行时间是不同的,可以根据具体的不合适选择。