python apscheduler 定时任务的基本使用-5-添加任务

1、添加定时任务

可以随时随地添加任务，不论调度器是否启动。如果未启动时，添加了定时任务，则会在调度器启动时，正常执行该任务。

添加方式有下面两种

1.1、通过add_job()函数添加

使用 add_job 方法添加任务，会返回一个Job对象，可以用于后续修改或删除任务，这是最普遍的添加任务的方式

例如

def add_job():
    # 使用 add_job 方法添加任务 返回一个Job对象 可以用于后续修改或删除任务
    date = datetime.datetime.now() + datetime.timedelta(seconds=20)  # 可以添加datetime对象作为运行时间
    job = scheduler.add_job(my_job, trigger='date', args=['墨玉麒麟', 18], name="墨玉麒麟JOB", run_date=date,
                            timezone=shanghai)
    print(f'job:{job}')
    scheduler.print_jobs()

1.2、通过装饰器scheduled_job()添加

使用装饰器时，需要先实例化出一个调度器对象，然后调用调度器对象的scheduled_job方法

@scheduler.scheduled_job('date', args=('装饰器参数',), run_date=run_date, name="装饰器", timezone=shanghai)
def my_job2(name):
    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    log(f"这是由装饰器添加的任务, 名称是:{name}  现在时间:{now}")

说明：

• scheduler.scheduled_job中的scheduler是创建出的调度器对象

参考代码

import datetime
import threading

from apscheduler.schedulers.blocking import BlockingScheduler


def log(msg):
    t = threading.currentThread()
    name = t.name
    ident = t.ident
    print(f"[{ident}][{name}]{msg}")  # 打印线程号和线程名称


def my_job(name, age):
    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    log(f"我是{name}, 今年{age}岁, 现在时间:{now}")
    scheduler.print_jobs()


def add_job():
    # 使用 add_job 方法添加任务 返回一个Job对象 可以用于后续修改或删除任务
    date = datetime.datetime.now() + datetime.timedelta(seconds=20)  # 可以添加datetime对象作为运行时间
    job = scheduler.add_job(my_job, trigger='date', args=['墨玉麒麟', 18], name="墨玉麒麟JOB", run_date=date,
                            timezone=shanghai)
    print(f'job:{job}')
    scheduler.print_jobs()


log(f'我是主线程, 现在时间:{datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")}')
shanghai = 'Asia/Shanghai'
scheduler = BlockingScheduler()  # 默认存储在内存,执行线程最大10个

run_date = datetime.datetime.now() + datetime.timedelta(seconds=30)


@scheduler.scheduled_job('date', args=('装饰器参数',), run_date=run_date, name="装饰器", timezone=shanghai)
def my_job2(name):
    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    log(f"这是由装饰器添加的任务, 名称是:{name}  现在时间:{now}")


add_job()

scheduler.print_jobs()

scheduler.start()
# 使用了BlockingScheduler 则无法执行start后面的代码

2、添加任务公共参数

添加任务时，我们根据触发器会添加对应的参数，除了这些参数外，有一些公共的参数，如下

• func 要执行的函数
• trigger 触发器
• args 执行函数的参数
• kwargs 执行函数的字典类型参数
• id 定时任务唯一标识
• name 任务的名称
• misfire_grace_time 任务执行的容错时间
  • 假设任务运行时间为10:50:00 但是系统死机了，重启系统后 现在已经是10:50:10了，如果设置了misfire_grace_time=20，则会继续运行该任务，否则不会运行该任务
  • 一般报错Run time of job "" was missed by xxx 可以通过调大该参数解决
  • 如果超过了任务执行时间N秒了，任务就不会运行了，但是设置misfire_grace_time 大于等于N，则会运行
• coalesce 任务堆叠后是否只执行最后一个任务
  • 如果任务超时了好久，且设置了misfire_grace_time ，堆积了多个任务，设置为True后，只会跑一个，否则跑多个
• max_instances 最大运行的任务数
• next_run_time 何时开始运行
• jobstore 存储器
  • 指定存储器，可以指定多个存储器，然后添加任务时，可以通过该参数指定数据存到哪一个数据库中
  • 可以参考【python apscheduler 定时任务的基本使用-6-sqlite数据库】的例子
• executor 执行器
• replace_existing 如果ID重复,是否替换任务

github