快捷導(dǎo)航

Django之定時(shí)任務(wù)django-crontab的實(shí)現(xiàn)

更新時(shí)間：2025年05月07日 10:57:19 作者：aobulaien001

Django可以使用第三方庫(kù)如django-crontab來(lái)實(shí)現(xiàn)定時(shí)任務(wù)的調(diào)度,本文主要介紹了Django之定時(shí)任務(wù)django-crontab的實(shí)現(xiàn),具有一定的參考價(jià)值,感興趣的可以了解一下

crontab

Django可以使用第三方庫(kù)如django-crontab來(lái)實(shí)現(xiàn)定時(shí)任務(wù)的調(diào)度。該庫(kù)允許使用類(lèi)似于crontab文件格式的語(yǔ)法指定任務(wù)的執(zhí)行時(shí)間。

GitHub地址：https://github.com/kraiz/django-crontab

安裝django-crontab

pip install django-crontab

注冊(cè)應(yīng)用

在settings.py文件中注冊(cè)django-crontab應(yīng)用

INSTALLED_APPS = [    
    'django_crontab', # 定時(shí)任務(wù)
]

定時(shí)時(shí)間格式

django-crontab使用Linux下常用的cron調(diào)度器進(jìn)行任務(wù)調(diào)度。對(duì)于時(shí)間格式的指定，它遵循標(biāo)準(zhǔn)的crontab語(yǔ)法，分為五個(gè)字段，從左到右依次為：

*     *     *     *     *
-     -     -     -     -
|     |     |     |     |
|     |     |     |     +----- day of the week (0 - 6) (Sunday=0) -------------d
|     |     |     +------- month (1 - 12) -------------m
|     |     +--------- day of the month (1 - 31) -------------D
|     +----------- hour (0 - 23) -------------H
+------------- min (0 - 59) -------------M

說(shuō)明：

M: 分鐘（0-59）每分鐘用 * 或者 */1 表示
H：小時(shí)（0-23）（0表示0點(diǎn)）
D：天（1-31）
m: 月（1-12）
d: 一星期內(nèi)的天（0~6，0為星期天）

星號(hào)（*）：所有可能的值，例如month字段如果是星號(hào)，則表示在滿(mǎn)足其它字段的制約條件后每月都執(zhí)行該命令操作

逗號(hào)（,）：可以用逗號(hào)隔開(kāi)的值指定一個(gè)列表范圍，例如: 1,2,5,7,8,9

中杠（-）：可以用整數(shù)之間的中杠表示一個(gè)整數(shù)范圍，例如: 2-6表示2,3,4,5,6

正斜線（/）：可以用正斜線指定時(shí)間的間隔頻率，例如: 0-23/2表示每?jī)尚r(shí)執(zhí)行一次。同時(shí)正斜線可以和星號(hào)一起使用，例如*/10，如果用在minute字段，表示每十分鐘執(zhí)行一次

注意：所有值都必須在相應(yīng)的范圍之內(nèi)，否則視為無(wú)效

定時(shí)時(shí)間示例

0 */1 * * *  # 每1小時(shí)執(zhí)行一次
0 10 * * *	# 每天10點(diǎn)執(zhí)行
30 19 * * *	# 每天19點(diǎn)30分執(zhí)行
0 10 * * 1	# 每周一10點(diǎn)執(zhí)行
30 17 * * 5	# 每周五17點(diǎn)30分執(zhí)行
0 10 1 10 *	# 每年10月1日10點(diǎn)執(zhí)行
0 5,17 * * *	# 每天5:00和17:00執(zhí)行任務(wù)
0 3 * * * # 表示每天凌晨三點(diǎn)執(zhí)行
*/5 * * * * # 表示每隔5分鐘執(zhí)行一次
0 0 1,15 * * # 表示每月1日和15日午夜執(zhí)行
30 8 1-7 * * # 表示每個(gè)月的前7天中，每日上午8:30執(zhí)行

設(shè)置定時(shí)任務(wù)

定時(shí)任務(wù)分為三部分定義：任務(wù)時(shí)間、任務(wù)方法、任務(wù)日志，在settings.py文件配置：

CRONJOBS = [
    # 每1分鐘執(zhí)行一次
    # users:應(yīng)用名，task為py文件名，task_job為文件中的函數(shù)
    ('*/1 * * * *', 'apps.users.task.task_job', '>> ' + os.path.join(BASE_DIR, 'logs/crontab.log')),
    # 每隔5分鐘運(yùn)行一次
    ('*/5 * * * *', 'apps.users.task.my_scheduled_job'),
]

@符號(hào)方法

django-crontab 支持使用 @ 符號(hào)來(lái)快速指定一些常見(jiàn)用法，例如：

@reboot：在系統(tǒng)啟動(dòng)時(shí)運(yùn)行一次

@yearly 或 @annually：每年1月1日 0:00 運(yùn)行一次

@monthly：每月1日 0:00 運(yùn)行一次

@weekly：每周日 0:00 運(yùn)行一次

@daily 或 @midnight：每天0:00 運(yùn)行一次

@hourly：每小時(shí)運(yùn)行一次

@yearly 或 @annually：表示每年執(zhí)行一次，相當(dāng)于 0 0 1 1 *

CRONJOBS = [
    ('@yearly', 'myapp.tasks.my_scheduled_job'),
]

@monthly：表示每月執(zhí)行一次，相當(dāng)于0 0 1 * *

CRONJOBS = [
    ('@monthly', 'myapp.tasks.my_scheduled_job'),
]

@weekly：表示每周執(zhí)行一次，相當(dāng)于 0 0 * * 0

CRONJOBS = [
    ('@weekly', 'myapp.tasks.my_scheduled_job'),
]

@daily 或 @midnight：表示每天午夜執(zhí)行一次，相當(dāng)于 0 0 * * *

CRONJOBS = [
    ('@daily', 'myapp.tasks.my_scheduled_job'),
]

@hourly：表示每小時(shí)執(zhí)行一次，相當(dāng)于0 * * * *

CRONJOBS = [
    ('@hourly', 'myapp.tasks.my_scheduled_job'),
]

解決crontab中文問(wèn)題

在定時(shí)任務(wù)中，如果出現(xiàn)非英文字符，會(huì)出現(xiàn)字符異常錯(cuò)誤

CRONTAB_COMMAND_PREFIX = 'LANG_ALL=zh_cn.UTF-8'

管理定時(shí)任務(wù)

1.執(zhí)行定時(shí)任務(wù)

# 添加定時(shí)任務(wù)到系統(tǒng)中
python manage.py crontab add

2.取消定時(shí)任務(wù)

# 移除定時(shí)任務(wù)
python manage.py crontab remove

3.查詢(xún)激活定時(shí)任務(wù)

# 顯示已激活的定時(shí)任務(wù)
python manage.py crontab show

注意

1.crontab不適用于Windows平臺(tái)。

2.django-crontab默認(rèn)使用的是UTC時(shí)間，與當(dāng)前系統(tǒng)時(shí)區(qū)可能不同。

可以在 settings.py 文件中指定CRONTAB_TIMEZONE選項(xiàng)來(lái)設(shè)置時(shí)區(qū)，例如：

將時(shí)區(qū)設(shè)置為東八區(qū)（GMT+8）

CRONTAB_TIMEZONE = ‘Asia/Shanghai'

到此這篇關(guān)于Django之定時(shí)任務(wù)django-crontab的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)django-crontab定時(shí)任務(wù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: