Python 轻量级的定时任务调度工具

0. 简介

schedule是一个轻量级的定时任务调度的库。它可以按每分钟，每小时，每天，周几，特定日期来制定定时任务。

1. 安装

schedule的安装非常简单，还是pip安装法，在命令行终端中输入以下内容：

pip install schedule

即可完成安装。

2. schedule定时任务

schedule的简单使用方法，上文中已经提到一个例子，这里分析一下这个例子的基本格式，也就是schedule的基本用法。

#首先第一步是创建方法
def func():
    print("这是一个方法")
    
#第二步创建定时器
schedule.every(10).seconds.do(func)  #每10秒运行一次
#如果方法需要传参的话do(func,参数1,参数2,...)
#第三步开启任务循环
while True:
    schedule.run_pending()
    time.sleep(1)

schedule定时格式：

schedule.every(10).minutes.do(job) #每（）.时间单位.执行（方法）

更多例子如下：

schedule.every(10).minutes.do(job)
schedule.every().hour.do(job)
schedule.every().day.at("10:30").do(job) #日期定时
schedule.every().monday.do(job)
schedule.every().wednesday.at("13:15").do(job)
schedule.every().day.at("12:42", "Europe/Amsterdam").do(job)
schedule.every().hour.at(":42").do(job)#每小时的第42分钟
schedule.every().minute.at(":17").do(job)#第分钟的第17

其中at()传递精确的时间点和时区等信息。

3. schedule取消定时任务

当程序触发某个条件时，我们可能需要撤回一个任务。例如，老板来了要开会，本来定时的工作安排要取消。具体方法如下：

import schedule
def some_task():
    print('Hello world')
job = schedule.every().day.at('22:30').do(some_task)
schedule.cancel_job(job)

4. 任务只执行一次

利用schedule.CancelJob触发程序执行一次后被撤销。

import schedule
import time
def job_that_executes_once():
    # 这里写一个只要执行一次的方法
    return schedule.CancelJob
schedule.every().day.at('22:30').do(job_that_executes_once)
while True:
    schedule.run_pending()
    time.sleep(1)

4. get所有任务和清除所有任务

4.1 get所有任务

import schedule
def hello():
    print('Hello world')
schedule.every().second.do(hello)
all_jobs = schedule.get_jobs()

4.2 清除所有任务

import schedule
def greet(name):
    print('Hello {}'.format(name))
schedule.every().second.do(greet,name)
schedule.clear()

5.任务过滤

利用tag给任务打标签式分类，可以get分类，也可以清除分类。

import schedule
def greet(name):
    print('Hello {}'.format(name))
schedule.every().day.do(greet, 'Andrea').tag('daily-tasks', 'friend')
schedule.every().hour.do(greet, 'John').tag('hourly-tasks', 'friend')
schedule.every().hour.do(greet, 'Monica').tag('hourly-tasks', 'customer')
schedule.every().day.do(greet, 'Derek').tag('daily-tasks', 'guest')
friends = schedule.get_jobs('friend')
schedule.clear('daily-tasks')

6.时间模糊

every(A).to(B)，在A到B的时间内执行。例如在5到10秒之间执行任务：

def my_job():
    print('你好')
# Run every 5 to 10 seconds.
schedule.every(5).to(10).seconds.do(my_job)

​​
7.到达指定时间，才开始执行任务

利用until()函数，完成到达指定时间后才开始执行任务。

import schedule
from datetime import datetime, timedelta, time
def job():
    print('Boo')
# 直到 18:30 才执行
schedule.every(1).hours.until("18:30").do(job)
# 直到 2030-01-01 18:33 
schedule.every(1).hours.until("2030-01-01 18:33").do(job)
#过8个小时后执行
schedule.every(1).hours.until(timedelta(hours=8)).do(job)
# 直到 11:33:42后
schedule.every(1).hours.until(time(11, 33, 42)).do(job)
# 到具体时间后执行
schedule.every(1).hours.until(datetime(2020, 5, 17, 11, 36, 20)).do(job)