Django的TimeField字段使用time__contains查询特定场景失效如何处理

• contains是Django专为字符串类型字段设计的模糊查询运算符，将其用于TimeField这类时间类型字段时，底层会触发数据库的隐式类型转换，将时间值转为字符串后再做子串匹配，匹配结果完全依赖数据库的时间转字符串规则，本身就属于不稳定的非规范用法。
• 不同数据库对时间值转字符串的格式化规则不一致：部分数据库会将小时值小于10的时间输出为不带前导零的格式（如8:15:00），而用户提交的08:15带前导零，字符串匹配时自然无法命中；当数据库存储的时间转字符串后带前导零（如08:15:00）时，子串匹配才能命中，这就是部分场景下查询正常的原因。

最稳妥的方案是避免对时间字段做字符串模糊匹配，将用户提交的时间字符串解析为Python标准datetime.time对象后，使用Django内置的时间字段查找器做数值匹配，完全规避格式化差异问题：

import datetime
from .models import WateringSchedule

t = '08:15'
# 解析用户提交的时分格式字符串为time对象
parsed_time = datetime.datetime.strptime(t, "%H:%M").time()

# 仅匹配小时、分钟一致的记录（忽略秒）
matched_count = WateringSchedule.objects.filter(
    time__hour=parsed_time.hour,
    time__minute=parsed_time.minute
).count()
print(matched_count)

如果业务逻辑要求时分秒完全一致，不需要忽略秒的话，代码可以更简洁：

# 若用户提交的时间带秒，如t = '08:15:00'，解析后直接做等值匹配即可
parsed_time = datetime.datetime.strptime(t, "%H:%M:%S").time()
matched_count = WateringSchedule.objects.filter(time=parsed_time).count()

该方案优势明显：

• 完全不依赖数据库的隐式转换行为，跨所有Django支持的数据库都能稳定运行
• 数值匹配的性能远高于字符串模糊匹配，time字段加索引后可以命中索引提升查询效率
• 天然规避前导零、格式不一致等字符串匹配常见问题

内容的提问来源于stack exchange，提问作者Martin Kubovčík