第python周期任務(wù)調(diào)度工具Schedule使用詳解目錄1.準(zhǔn)備2.基本使用參數(shù)傳遞獲取目前所有的作業(yè)取消所有作業(yè)標(biāo)簽功能設(shè)定作業(yè)截止時間3.高級使用裝飾器安排作業(yè)并行執(zhí)行日志記錄異常處理如果你想周期性地執(zhí)行某個Python腳本，最出名的選擇應(yīng)該是Crontab腳本，但是Crontab具有以下缺點(diǎn)：

1.不方便執(zhí)行秒級任務(wù)。

2.當(dāng)需要執(zhí)行的定時任務(wù)有上百個的時候，Crontab的管理就會特別不方便。

還有一個選擇是Celery，但是Celery的配置比較麻煩，如果你只是需要一個輕量級的調(diào)度工具，Celery不會是一個好選擇。

在你想要使用一個輕量級的任務(wù)調(diào)度工具，而且希望它盡量簡單、容易使用、不需要外部依賴，最好能夠容納Crontab的所有基本功能，那么Schedule模塊是你的不二之選。

使用它來調(diào)度任務(wù)可能只需要幾行代碼，感受一下：

importschedule

importtime

defjob():

print("I'mworking...")

schedule.every(10).minutes.do(job)

whileTrue:

schedule.run_pending()

time.sleep(1)

上面的代碼表示每10分鐘執(zhí)行一次job函數(shù)，非常簡單方便。你只需要引入schedule模塊，通過調(diào)用scedule.every(時間數(shù)).時間類型.do(job)發(fā)布周期任務(wù)。

發(fā)布后的周期任務(wù)需要用run_pending函數(shù)來檢測是否執(zhí)行，因此需要一個While循環(huán)不斷地輪詢這個函數(shù)。

下面具體講講Schedule模塊的安裝和初級、進(jìn)階使用方法。

1.準(zhǔn)備

開始之前，你要確保Python和pip已經(jīng)成功安裝在電腦上，請選擇以下任一種方式輸入命令安裝依賴：

Windows環(huán)境打開Cmd(開始-運(yùn)行-CMD)。

MacOS環(huán)境打開Terminal(command+空格輸入Terminal)。

如果你用的是VSCode編輯器或Pycharm，可以直接使用界面下方的Terminal.

pipinstallschedule

2.基本使用

最基本的使用在文首已經(jīng)提到過，下面給大家展示更多的調(diào)度任務(wù)例子：

importschedule

importtime

defjob():

print("I'mworking...")

#每十分鐘執(zhí)行任務(wù)

schedule.every(10).minutes.do(job)

#每個小時執(zhí)行任務(wù)

schedule.every().hour.do(job)

#每天的10:30執(zhí)行任務(wù)

schedule.every().day.at("10:30").do(job)

#每個月執(zhí)行任務(wù)

schedule.every().monday.do(job)

#每個星期三的13:15分執(zhí)行任務(wù)

schedule.every().wednesday.at("13:15").do(job)

#每分鐘的第17秒執(zhí)行任務(wù)

schedule.every().minute.at(":17").do(job)

whileTrue:

schedule.run_pending()

time.sleep(1)

可以看到，從月到秒的配置，上面的例子都覆蓋到了。不過如果你想只運(yùn)行一次任務(wù)的話，可以這么配

importschedule

importtime

defjob_that_executes_once():

#此處編寫的任務(wù)只會執(zhí)行一次...

returnschedule.CancelJob

schedule.every().day.at('22:30').do(job_that_executes_once)

whileTrue:

schedule.run_pending()

time.sleep(1)

參數(shù)傳遞

如果你有參數(shù)需要傳遞給作業(yè)去執(zhí)行，你只需要這么做：

importschedule

defgreet(name):

print('Hello',name)

#do()將額外的參數(shù)傳遞給job函數(shù)

schedule.every(2).seconds.do(greet,name='Alice')

schedule.every(4).seconds.do(greet,name='Bob')

獲取目前所有的作業(yè)

如果你想獲取目前所有的作業(yè)：

importschedule

defhello():

print('Helloworld')

schedule.every().second.do(hello)

all_jobs=schedule.get_jobs()

取消所有作業(yè)

如果某些機(jī)制觸發(fā)了，你需要立即清除當(dāng)前程序的所有作業(yè)：

importschedule

defgreet(name):

print('Hello{}'.format(name))

schedule.every().second.do(greet)

schedule.clear()

標(biāo)簽功能

在設(shè)置作業(yè)的時候，為了后續(xù)方便管理作業(yè)，你可以給作業(yè)打個標(biāo)簽，這樣你可以通過標(biāo)簽過濾獲取作業(yè)或取消作業(yè)。

importschedule

defgreet(name):

print('Hello{}'.format(name))

#.tag打標(biāo)簽

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')

#get_jobs(標(biāo)簽)：可以獲取所有該標(biāo)簽的任務(wù)

friends=schedule.get_jobs('friend')

#取消所有daily-tasks標(biāo)簽的任務(wù)

schedule.clear('daily-tasks')

設(shè)定作業(yè)截止時間

如果你需要讓某個作業(yè)到某個時間截止，你可以通過這個方法：

importschedule

fromdatetimeimportdatetime,timedelta,time

defjob():

print('Boo')

#每個小時運(yùn)行作業(yè)，18:30后停止

schedule.every(1).hours.until("18:30").do(job)

#每個小時運(yùn)行作業(yè)，2030-01-0118:33today

schedule.every(1).hours.until("2030-01-0118:33").do(job)

#每個小時運(yùn)行作業(yè)，8個小時后停止

schedule.every(1).hours.until(timedelta(hours=8)).do(job)

#每個小時運(yùn)行作業(yè)，11:32:42后停止

schedule.every(1).hours.until(time(11,33,42)).do(job)

#每個小時運(yùn)行作業(yè)，2025-5-1711:36:20后停止

schedule.every(1).hours.until(datetime(2025,5,17,11,36,20)).do(job)

截止日期之后，該作業(yè)將無法運(yùn)行。

立即運(yùn)行所有作業(yè)，而不管其安排如何

如果某個機(jī)制觸發(fā)了，你需要立即運(yùn)行所有作業(yè)，可以調(diào)用schedule.run_all():

importschedule

defjob_1():

print('Foo')

defjob_2():

print('Bar')

schedule.every().monday.at("12:40").do(job_1)

schedule.every().tuesday.at("16:40").do(job_2)

schedule.run_all()

#立即運(yùn)行所有作業(yè)，每次作業(yè)間隔10秒

schedule.run_all(delay_seconds=10)

3.高級使用

裝飾器安排作業(yè)

如果你覺得設(shè)定作業(yè)這種形式太啰嗦了，也可以使用裝飾器模式：

fromscheduleimportevery,repeat,run_pending

importtime

#此裝飾器效果等同于schedule.every(10).minutes.do(job)

@repeat(every(10).minutes)

defjob():

print("Iamascheduledjob")

whileTrue:

run_pending()

time.sleep(1)

并行執(zhí)行

默認(rèn)情況下，Schedule按順序執(zhí)行所有作業(yè)。其背后的原因是，很難找到讓每個人都高興的并行執(zhí)行模型。

不過你可以通過多線程的形式來運(yùn)行每個作業(yè)以解決此限制：

importthreading

importtime

importschedule

defjob1():

print("I'mrunningonthread%s"%threading.current_thread())

defjob2():

print("I'mrunningonthread%s"%threading.current_thread())

defjob3():

print("I'mrunningonthread%s"%threading.current_thread())

defrun_threaded(job_func):

job_thread=threading.Thread(target=job_func)

job_thread.start()

schedule.every(10).seconds.do(run_threaded,job1)

schedule.every(10).seconds.do(run_threaded,job2)

schedule.every(10).seconds.do(run_threaded,job3)

whileTrue:

schedule.run_pending()

time.sleep(1)

日志記錄

Schedule模塊同時也支持logging日志記錄，這么使用：

importschedule

importlogging

logging.basicConfig()

schedule_logger=logging.getLogger('schedule')

#日志級別為DEBUG

schedule_logger.setLevel(level=logging.DEBUG)

defjob():

print("Hello,Logs")

schedule.every().second.do(job)

schedule.run_all()

schedule.clear()

效果如下：

DEBUG:schedule:Running*all*1jobswith0sdelayinbetween

DEBUG:schedule:RunningjobJob(interval=1,unit=seconds,do=job,args=(),kwargs={})

Hello,Logs

DEBUG:schedule:Deleting*all*jobs

異常處理

Schedule不會自動捕捉異常，它遇到異常會直接拋出，這會導(dǎo)致一個嚴(yán)重的問題：后續(xù)所有的作業(yè)都會被中斷執(zhí)行，因此我們需要捕捉到這些異常。

你可以手動捕捉，但是某些你預(yù)料不到的情況需要程序進(jìn)行自動捕獲，加一個裝飾器就能做到了：

importfunctools

defcatch_exceptions(cancel_on_failure=False):

defcatch_exceptions_d