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

二、Python兼职渠道推荐*

学的同时助你创收，每天花1-2小时兼职，轻松稿定生活费.

三、最新Python学习笔记

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

四、实战案例

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

👉CSDN大礼包🎁：全网最全《Python学习资料》免费赠送🆓！（安全链接，放心点击）

若有侵权，请联系删除