目录
- crontab
- 安装django-crontab
- 注册应用
- 定时时刻格式
- 定时时刻示例
- 设置定时任务
- @符号技巧
- 解决crontab中文难题
- 管理定时任务
- 注意
- 将时区设置为东八区(GMT+8)
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定时任务内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客!
无论兄弟们可能感兴趣的文章:
- Django定时任务Django-crontab的使用详解
- Django crontab定时任务模块操作技巧解析
- django-crontab实现服务端的定时任务的示例代码
- 使用django-crontab实现定时任务的示例