Django之定时任务django-crontab的实现

crontab

django可以使用第三方库如django-crontab来实现定时任务的调度。该库允许使用类似于crontab文件格式的语法指定任务的执行时间。

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

安装django-crontab

pip install django-crontab

注册应用

在settings.py文件中注册django-crontab应用

installed_apps = [    
    'django_crontab', # 定时任务
]

定时时间格式

django-crontab使用linux下常用的cron调度器进行任务调度。对于时间格式的指定,它遵循标准的crontab语法,分为五个字段,从左到右依次为:

*     *     *     *     *
-     -     -     -     -
|     |     |     |     |
|     |     |     |     +----- 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

说明:

m: 分钟(0-59)每分钟用 * 或者 */1 表示
h:小时(0-23)(0表示0点)
d:天(1-31)
m: 月(1-12)
d: 一星期内的天(0~6,0为星期天)

星号(*):所有可能的值,例如month字段如果是星号,则表示在满足其它字段的制约条件后每月都执行该命令操作

逗号(,):可以用逗号隔开的值指定一个列表范围,例如: 1,2,5,7,8,9

中杠(-):可以用整数之间的中杠表示一个整数范围,例如: 2-6表示2,3,4,5,6

正斜线(/):可以用正斜线指定时间的间隔频率,例如: 0-23/2表示每两小时执行一次。同时正斜线可以和星号一起使用,例如*/10,如果用在minute字段,表示每十分钟执行一次

注意: 所有值都必须在相应的范围之内,否则视为无效

定时时间示例

0 */1 * * *  # 每1小时执行一次
0 10 * * *	# 每天10点执行
30 19 * * *	# 每天19点30分执行
0 10 * * 1	# 每周一10点执行
30 17 * * 5	# 每周五17点30分执行
0 10 1 10 *	# 每年10月1日10点执行
0 5,17 * * *	# 每天5:00和17:00执行任务
0 3 * * * # 表示每天凌晨三点执行
*/5 * * * * # 表示每隔5分钟执行一次
0 0 1,15 * * # 表示每月1日和15日午夜执行
30 8 1-7 * * # 表示每个月的前7天中,每日上午8:30执行

设置定时任务

定时任务分为三部分定义:任务时间、任务方法、任务日志,在settings.py文件配置:

cronjobs = [
    # 每1分钟执行一次
    # users:应用名,task为py文件名,task_job为文件中的函数
    ('*/1 * * * *', 'apps.users.task.task_job', '>> ' + os.path.join(base_dir, 'logs/crontab.log')),
    # 每隔5分钟运行一次
    ('*/5 * * * *', 'apps.users.task.my_scheduled_job'),
]

@符号方法

django-crontab 支持使用 @ 符号来快速指定一些常见用法,例如:

@reboot:在系统启动时运行一次

@yearly 或 @annually:每年1月1日 0:00 运行一次

@monthly:每月1日 0:00 运行一次

@weekly:每周日 0:00 运行一次

@daily 或 @midnight:每天0:00 运行一次

@hourly:每小时运行一次

@yearly 或 @annually:表示每年执行一次,相当于0 0 1 1 *

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

@monthly:表示每月执行一次,相当于0 0 1 * *

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

@weekly:表示每周执行一次,相当于0 0 * * 0

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

@daily 或 @midnight:表示每天午夜执行一次,相当于0 0 * * *

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

@hourly:表示每小时执行一次,相当于0 * * * *

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

解决crontab中文问题

在定时任务中,如果出现非英文字符,会出现字符异常错误

crontab_command_prefix = 'lang_all=zh_cn.utf-8'

管理定时任务

1.执行定时任务

# 添加定时任务到系统中
python manage.py crontab add

2.取消定时任务

# 移除定时任务
python manage.py crontab remove

3.查询激活定时任务

# 显示已激活的定时任务
python manage.py crontab show

注意

1.crontab不适用于windows平台。

2.django-crontab默认使用的是utc时间,与当前系统时区可能不同。

可以在 settings.py 文件中指定crontab_timezone选项来设置时区,例如:

将时区设置为东八区(gmt+8)

crontab_timezone = ‘asia/shanghai'

到此这篇关于django之定时任务django-crontab的实现的文章就介绍到这了,更多相关django-crontab定时任务内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

发布于 2025-05-07 21:52:23
分享
海报
154
上一篇:Selenium模拟用户进行操作网页的最全指南 下一篇:Android 实现一个隐私弹窗功能
目录

    推荐阅读

    忘记密码?

    图形验证码