Django定时任务django-crontab 的使用

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