1、前言
在做 django 开发需求时,多多少少都会遇到需要定时任务的功能,比如定时执行任务,检查订单之类的。可能是一段时间,比如每隔 10分钟执行一次,也可能是定点时间,比如 14:00 执行,也可能是长时间,比如每周几,每个月的哪一天等。查看了一下相关资料, django 定时任务 django-crontab
库比较多教程和资料,虽然 star 数才五百,但是 API 接口比较简单,接入也很方便,功能也很全面,当然,也存在一此无法解决的问题,使用时需要注意的。
2、使用教程
1.安装:
pip install django-crontab
2.添加配置到 settings.py INSTALLED_APPS
中
INSTALLED_APPS = (
'django_crontab',
...
)
3.编写定时函数:
定时任务可以分成两种,一种是执行自定义的mange.py的命令,另一种是执行自定义函数。
在django的app中新建一个myapp/cron.py文件,把需要定时执行的代码放进去
示例:
def my_scheduled_job():
pass
4.在 settings.py 中增加CRONJOBS
配置
CRONJOBS = [
('*/5 * * * *', 'myapp.cron.my_scheduled_job')
]
也可以定义一些关键字参数,有2种格式:
格式1:
- 要求:cron计时通常格式(有关更多示例,请参阅 Wikipedia 和 crontab.guru)
- 要求:python模块路径下待执行定时任务
- 可选:特定于定时任务的后缀(例如,将
out/err
重定向到文件,默认值为'')
示例:
CRONJOBS = [
('*/1 * * * *', 'appname.test_crontab.test','>>/home/python/test_crontab.log')
]
注意: >>
表示追加写入,>
表示覆盖写入。
解决中文字符问题
在settings.py中设置使用中文
# 解决crontab中文问题
CRONTAB_COMMAND_PREFIX = 'LANG_ALL=zh_cn.UTF-8'
* 代表所有的取值范围的数字
/ 代表每的意思,*/5就是每5个单位
- 代表从某个数字到某个数字
, 分开几个离散的数字
示例:
每两个小时 0 */2 * * *
晚上11点到早上8点之间每两个小时,早上8点 0 23-7,8 * * *
每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点 0 11 4 * 1-3
1月1日早上4点 0 4 1 1 *
示例:
每两个小时 0 */2 * * *
晚上11点到早上8点之间每两个小时,早上8点 0 23-7,8 * * *
每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点 0 11 4 * 1-3
1月1日早上4点 0 4 1 1 *
0 6 * * * commands >> /tmp/test.log # 每天早上6点执行, 并将信息追加到test.log中
0 */2 * * * commands # 每隔2小时执行一次
5.添加并启动定时任务
#添加并启动定时任务
python manage.py crontab add
其它命令:
#显示当前的定时任务
python manage.py crontab show
#删除所有定时任务
python manage.py crontab remove