1 取消定时任务

比如当满足一定条件时，就取消定时任务，在这种场景下，不可能说把进程干掉，所以可以利用取消定时任务的功能

如下代码，通过count控制当执行了5此以后，就取消定时任务

import schedule
import time
count=0
def do_func(name,age):
    global count
    count+=1
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
def main():
    job=schedule.every(2).seconds.do(do_func,"张三丰",100)
    while True:
        if count>=5:
            schedule.cancel_job(job)
        schedule.run_pending()
if __name__=="__main__":
    main()

执行结果如下，可以看到当执行完5此打印后，进程并没有退出，但是定时任务不再执行了

2022-05-25 00:03:15 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:03:17 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:03:19 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:03:21 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:03:23 in do func : 姓名：张三丰 年龄：100

2 定时任务只执行一次

定时任务执行一次似乎是没啥意义的，但是在某些场景下，比如执行了一定次数后，当满足一定条件时只需要再执行一次，这个时候就派上用场了

如下为单纯的只执行一次的定时任务

import time
def do_func(name,age):
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
    return schedule.CancelJob
def main():
    schedule.every(2).seconds.do(do_func,"张三丰",100)
    while True:
        schedule.run_pending()
if __name__=="__main__":
    main()

执行结果如下，可以发现，执行完一次就不再执行了

2022-05-25 00:14:20 in do func : 姓名：张三丰 年龄：100

执行一次的定时任务的原理其实是在任务函数结尾返回了一个取消任务的消息，这里真正的价值在于将任务是否结束的决定权交给了任务函数，即可以在任务函数中进行条件判断，当达到一定的业务逻辑条件时，可以返回取消定时任务的消息，这样设置定时任务就更加灵活了

如下，可以在业务中判断是否具备停下来的条件，当条件满足了就停下来不再执行了

import schedule
import time
count=1
def do_func(name,age):
    global count
    count+=1
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
    if count >= 5:
        print("已经执行5次了，达到预期结果了，不需要再执行了...")
        return schedule.CancelJob
def main():
    schedule.every(2).seconds.do(do_func,"张三丰",100)
    while True:
        schedule.run_pending()
if __name__=="__main__":
    main()

执行结果如下：

2022-05-25 00:19:30 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:19:32 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:19:34 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:19:36 in do func : 姓名：张三丰 年龄：100
2022-05-25 00:19:38 in do func : 姓名：张三丰 年龄：100
已经执行5次了，达到预期结果了，不需要再执行了...

3 获取所有的定时任务

获取所有的定时任务作用就是可以根据一定的条件，对某些满足条件的定时任务进行各种操作如修改等

如下代码为对间隔3的任务从每3秒修改为每3分钟

import schedule
import time
def do_func(name,age):
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
def main():
    schedule.every(2).seconds.do(do_func,"张三丰",100)
    schedule.every(3).seconds.do(do_func, "张三丰", 200)
    all_jobs=schedule.get_jobs()
    print("原始定时任务：")
    for job in all_jobs:
        print(job)
    for job in all_jobs:
        if job.interval ==3:
            job.unit="minutes"
    print("修改后的定时任务：")
    for job in all_jobs:
        print(job)
if __name__=="__main__":
    main()

执行结果如下：

原始定时任务：
Job(interval=2, unit=seconds, do=do_func, args=('张三丰', 100), kwargs={})
Job(interval=3, unit=seconds, do=do_func, args=('张三丰', 200), kwargs={})
修改后的定时任务：
Job(interval=2, unit=seconds, do=do_func, args=('张三丰', 100), kwargs={})
Job(interval=3, unit=minutes, do=do_func, args=('张三丰', 200), kwargs={})

4 取消所有任务

如下为取消所有任务的代码，取消之前显示有两个任务，取消后显示有0个定时任务

import schedule
import time
def do_func(name,age):
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
def main():
    schedule.every(2).seconds.do(do_func,"张三丰",100)
    schedule.every(3).seconds.do(do_func, "张三丰", 200)
    print(len(schedule.get_jobs()))
    schedule.clear()
    print(len(schedule.get_jobs()))
if __name__=="__main__":
    main()

执行结果为：

2
0

5 给定时任务打标签，同样通过标签获取或取消定时任务

如下代码演示了给任务打标签，根据标签挑选任务，根据标签清除任务等操作

import schedule
import time
def do_func(name,age):
    print(time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))+" in do func : 姓名："+name+" 年龄："+str(age))
def main():
    # 定义定时任务时直接打标签
    schedule.every(2).seconds.do(do_func,"张三丰",100).tag("demo1","demo2")
    schedule.every(3).seconds.do(do_func, "张三丰", 200).tag("demo2","demo3")
    schedule.every(4).seconds.do(do_func, "张三丰", 300).tag("demo3", "demo4")
    # 根据demo2标签选择任务
    demo2=schedule.get_jobs("demo2")
    print("根据demo2标签挑选出的任务")
    for job in demo2:
        print(job)
    # 根据标签取消定时任务
    schedule.clear("demo3")
    all_job=schedule.get_jobs()
    print("删除demo3标签的任务后，剩余的任务")
    for job in all_job:
        print(job)
if __name__=="__main__":
    main()

执行结果如下：

根据demo2标签挑选出的任务
Job(interval=2, unit=seconds, do=do_func, args=('张三丰', 100), kwargs={})
Job(interval=3, unit=seconds, do=do_func, args=('张三丰', 200), kwargs={})
删除demo3标签的任务后，剩余的任务
Job(interval=2, unit=seconds, do=do_func, args=('张三丰', 100), kwargs={})