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’


---------------------------END---------------------------

题外话

在这里插入图片描述

感兴趣的小伙伴,赠送全套Python学习资料,包含面试题、简历资料等具体看下方。

??CSDN大礼包??:全网最全《Python学习资料》免费赠送??!(安全链接,放心点击)

一、Python所有方向的学习路线

Python所有方向的技术点做的整理,形成各个领域的知识点汇总,它的用处就在于,你可以按照下面的知识点去找对应的学习资源,保证自己学得较为全面。

img

二、Python兼职渠道推荐*

学的同时助你创收,每天花1-2小时兼职,轻松稿定生活费.
在这里插入图片描述

三、最新Python学习笔记

当我学到一定基础,有自己的理解能力的时候,会去阅读一些前辈整理的书籍或者手写的笔记资料,这些笔记详细记载了他们对一些技术点的理解,这些理解是比较独到,可以学到不一样的思路。

img

四、实战案例

纸上得来终觉浅,要学会跟着视频一起敲,要动手实操,才能将自己的所学运用到实际当中去,这时候可以搞点实战案例来学习。

img

??CSDN大礼包??:全网最全《Python学习资料》免费赠送??!(安全链接,放心点击)

若有侵权,请联系删除