Python3-apscheduler模块-定时调度

from apscheduler.schedulers.background import BackgroundScheduler, BlockingScheduler
from apscheduler.jobstores.redis import RedisJobStore
from apscheduler.jobstores.sqlalchemy import SQLAlchemyJobStore
from apscheduler.executors.pool import ThreadPoolExecutor, ProcessPoolExecutor

def print_args(*args):
    """
    要定时执行的函数
    :param args: 参数
    :return: None
    """
    for arg in args:
        print(arg)

# 执行器  常用的就线程池和进程池两种
thread_pool = ThreadPoolExecutor(30)
process_pool = ProcessPoolExecutor(5)
executors = {
    'thread': thread_pool,
    'process': process_pool
}

# 存储器 默认使用内存,对定时任务丢失什么的不敏感,对定时任务执行要求低
redis_store = RedisJobStore(host='172.16.120.120', port='')
sqlite_store = SQLAlchemyJobStore(url='sqlite:///jobs.sqlite')
jobstores = {
    'redis': redis_store,
    'default': sqlite_store
}
# 删除被持久化的定时任务 redis_store.remove_all_jobs()

# 调度器
# 调度器配置
job_defaults = {
    'coalesce': False,
    'max_instances': 5,
    'misfire_grace_time': 60
}
# coalesce：当由于某种原因导致某个job积攒了好几次没有实际运行（比如说系统挂了5分钟后恢复，有一个任务是每分钟跑一次的，按道理说这5分钟内本来是“计划”运行5次的，但实际没有执行），如果coalesce为True，下次这个job被submit给executor时，只会执行1次，也就是最后这次，如果为False，那么会执行5次（不一定，因为还有其他条件，看后面misfire_grace_time的解释）
# max_instance: 就是说同一个job同一时间最多有几个实例再跑，比如一个耗时10分钟的job，被指定每分钟运行1次，如果我们max_instance值为5，那么在第6~10分钟上，新的运行实例不会被执行，因为已经有5个实例在跑了
# misfire_grace_time：设想和上述coalesce类似的场景，如果一个job本来14:00有一次执行，但是由于某种原因没有被调度上，现在14:01了，这个14:00的运行实例被提交时，会检查它预订运行的时间和当下时间的差值（这里是1分钟），大于我们设置的30秒限制，那么这个运行实例不会被执行。

# scheduler = BlockingScheduler(jobstores=jobstores, executors=executors, job_defaults=job_defaults, daemonic=False)  # 实例化定时任务调度对象(阻塞方式)
scheduler = BackgroundScheduler(jobstores=jobstores, executors=executors, job_defaults=job_defaults, daemonic=False)  # 实例化定时任务调度对象(非阻塞方式)
scheduler.add_job(id='my_job_id1', jobstore='redis',executor='processpool',func=print_args, args=["Hello,World!"], trigger='date', run_date='2018-06-18 12:56:00')  # 表示在2018-06-18 12:56:00执行

# 触发器
# 三种执行方式 trigger='date' trigger='interval' trigger='cron'
# 1.date 定时调度 默认 指定时间执行一次
scheduler.add_job(func=print_args, args=["Hello,World!"], trigger='date', run_date='2018-06-18 12:56:00')  # 表示在2018-06-18 12:56:00执行
# 2.interval 间隔调度 指定时间间隔重复执行
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', days=3, hours=17, minutes=19,seconds=7)  # 表示每隔3天17时19分07秒执行一次任务
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', hours=17, minutes=19,seconds=7)  # 表示每隔17时19分07秒执行一次任务
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', minutes=19, seconds=7)  # 表示每隔19分07秒执行一次任务
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', minutes=19)  # 表示每隔19分执行一次任务
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', seconds=1)  # 表示每秒执行一次任务
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='interval', seconds=0.5)  # 表示每500毫秒执行一次任务
# 3. cron 定时调度（指定时刻执行）
# [参数取值范围]
# year (int|str) – 4-digit year -（表示四位数的年份，如2008年）
# month (int|str) – month (1-12) -（表示取值范围为1-12月）
# day  (int|str) – day of the (1-31) -（表示取值范围为1-31日）
# week (int|str) – ISO week (1-53) -（格里历2006年12月31日可以写成2006年-W52-7（扩展形式）或2006W527（紧凑形式））
# day_of_week (int|str) – number or name of weekday (0-6 or mon,tue,wed,thu,fri,sat,sun) - （表示一周中的第几天，既可以用0-6表示也可以用其英语缩写表示）
# hour (int|str) – hour (0-23) - （表示取值范围为0-23时）
# minute (int|str) – minute (0-59) - （表示取值范围为0-59分）
# second (int|str) – second (0-59) - （表示取值范围为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) -（表示时区取值）
# [参数取值格式]
# *            any    Fire on every value      如: day='*' 即,每天执行
# */a        any    Fire every a values, starting from the minimum  如: hour='*/2' 即,每两小时执行
# a-b        any    Fire on any value within the a-b range (a must be smaller than b)   如: minute='6-8,21-23' 即,6-8点和21-23点执行
# a-b/c        any    Fire every c values within the a-b range 如: minute='9-21/2' 即,9点-21点之间每两小时执行
# 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 # 表达式之间用逗号进行分隔
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='cron', year=2018, month=3, day=21, hour=21, minute=19,
                  second=8)  # 表示2018年3月21日21时19分08秒执行
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='cron', day_of_week='mon-fri', hour=5, minute=30,start_date='2016-06-06',end_date='2018-08-08')  # 表示周一到周五的5点半执行,有效日期是2016-06-06 00:00:00 至 2018-08-08 00:00:00
scheduler.add_job(func=print_args, args=['a', 'b', 'c'], trigger='cron', second='*/10')  # 表示每10秒执行该程序一次，相当于interval 间隔调度中seconds = 10

scheduler.start()  # 开始调度
scheduler.shutdown()  # 停止调度
scheduler.pause_job(job_id='my_job_id')  # 暂停指定JOB调度
scheduler.resume_job(job_id='my_job_id')  # 恢复指定JOB调度
scheduler.pause()  # 暂停调度
scheduler.resume()  # 恢复调度

 参考资料

　　http://apscheduler.readthedocs.io/en/latest/userguide.html

　　https://www.cnblogs.com/quijote/p/4385774.html