导读
如果你曾在 Odoo 中打开过销售订单、项目任务或生产单，就已经在日常操作中和日期字段打过交道。交货期、到期日、合同起止日等所有与时间相关的重要信息，通常都用日期字段来记录。
对普通用户来说，日期字段看起来很简单：点一下弹出日历，选个日期就行。但在数据模型层面，这个字段的设计讲究很多：它如何存储、与 DateTime 有何不同、如何在模块中创建或扩展，这些都会影响工作流准确性并避免时区引发的意外。
本篇指南将从基础到实操，全面说明 Odoo 的日期字段：它保存什么、如何在业务流程中正确使用，以及开发和配置时该注意哪些点。
在 Odoo 中，什么是“日期”字段
在 Odoo 的 ORM 里，日期字段（fields.Date）只保存日历日期，不包含时分秒。换句话说，像“2026-03-06”这样的值只表示那一天本身，不带时间戳。
在底层数据库 PostgreSQL 中，这类字段对应的是 DATE 类型，与保存完整时间戳的 TIMESTAMP（用于 DateTime 字段）并不相同。
界面上，日期字段通常表现为一个可输入框并带日历选择器；在列表里以本地化格式显示为文本，便于阅读与筛选。
字段在自定义模块中的定义方式（示例）
（示例代码）在自定义 Python 模块里，你会用 fields.Date 在模型上声明一个字段，并写明标签、说明等元信息。
如果通过 Odoo Studio 新建，会看到一个名为“Date”的控件；Studio 自动加上 x_studio_ 前缀。用代码或 API 创建时，你可以自定义技术字段名。
日期字段的工作原理
日期（Date）与日期时间（DateTime）的本质差别
最关键的区别是：日期字段不含时间。它只表达一个日历日，不涉及小时、分钟或时区转换。
而 DateTime 存储完整的 UTC 时间戳，展示时会根据用户时区转换。这种行为常常导致“日期看起来被前移或后移了一天”的疑惑，尤其在跨时区团队中。
使用日期字段时，存进去的值就是所有用户看到的值：2026-03-15 在任何时区都表示那一天。
重要字段属性概览
下面列出在 Odoo 中常用且需要注意的日期字段属性：
- required：使字段在界面与模型层面成为必填项。
- default：设置默认值，例如 fields.Date.today 可默认为当天。
- index：为该字段建数据库索引，加快按日期筛选和报表查询。
- compute：用 Python 方法动态计算字段值。
- store：与 compute 结合时可将计算结果写回数据库。
- readonly：界面上禁止用户编辑。
- copy：控制复制记录时是否带上该值（默认 True）。
在视图中的展现形式
在表单视图中会有日历弹出控件；在列表视图中以本地化格式展示；搜索视图自带区间筛选（本周、本月、本季度）以及精确的比较运算符（之前、之后、在某日）。
显示格式遵循用户语言设置：美国用户常见 MM/DD/YYYY，欧洲常见 DD/MM/YYYY，但数据库里始终以 ISO 格式（YYYY-MM-DD）存储。
与 Odoo ORM 的交互方式
通过 ORM 读取时，日期字段返回 Python 的 datetime.date 对象，空值则为 False；写入时可传 datetime.date 或 ISO 格式字符串。通过 XML-RPC 接口，日期通常以字符串形式传递。
处理日期字段不需要复杂转换；框架会自动处理格式化与存储，这也是日期字段在开发和配置中广受欢迎的原因。
真实业务场景中的应用
日期字段在 Odoo 的多个模块中随处可见，下面列举五个常见的业务实例以便理解其实用性。
CRM：合同起止日管理
销售机会和合同常常需要记录生效与到期日期，借助日期字段可以直观跟踪合同的生命周期。
结合自动化动作（Automated Actions），在合同临近到期时触发续约提醒或状态变更，能显著减少人工遗漏与流失。
销售：客户要求交期
客户下单时常会提出期望交货日。许多公司会在销售订单上增加“客户要求交期”字段，帮助运营团队明确计划目标。
用 Date 而非 DateTime 有助于避免时区转换带来的混淆，仓库与生产看到的是销售同事输入的同一天日期。
库存：批次有效期管理
在食品、医药和化工等行业，需要对批次的到期日和最佳食用期进行管理，Odoo 的批次（stock.lot）上会使用日期字段保存这些信息。
这些日期驱动 FEFO（先过期先出）拣选策略和到期告警，帮助合规与品质控制，无需人工频繁核查。
会计：发票到期日
发票的到期日属于日期字段，它决定了自动催收邮件的发送、逾期判定以及账龄报表的计算逻辑。
发票到期日错误会悄然破坏现金流监控和后续自动化，是操作上最关键的日期用途之一。
人力：入职、合同与证书到期
HR 依赖日期字段记录入职日、试用期结束、合同期和证书有效期等，这些数据触发邮件、提醒或工资规则。
一个稳健的 HR 模块离不开员工资料上准确的日期字段数据，这些日期常常是关键自动化的触发器。
如何创建或定制日期字段
根据你的技术背景和部署方式，有三种常见方式可以把日期字段加入模型：
通过 Odoo Studio（无代码）
Odoo Studio 是不写代码就能新增日期字段的最快方法，适合业务用户和顾问快速在标准表单上增加日期跟踪：
- 从主菜单打开 Odoo Studio。
- 定位到想修改的表单。
- 从侧边栏拖拽“Date”控件到表单上。
- 设置标签、是否必填和默认值（如需）。
- 保存并退出 Studio。
Studio 会自动以 x_studio_ 前缀创建字段并即时把它放到视图上，无需你手动做数据库迁移。
通过 Python 在自定义模块中定义
开发者在模块里通过 Python 声明日期字段，适用于需要版本控制并在多个环境部署的定制：
（示例代码）在模型里使用 fields.Date 声明字段，并可指定索引、copy、help 等属性。
把字段加到模型后，还需在视图的 XML 中把对应控件放上去，安装或升级模块时 Odoo 会自动在数据库中创建列。
通过 XML-RPC API 程序化创建字段
在自动化部署或远程配置场景，可用 XML-RPC 接口创建日期字段：
（示例代码）调用 ir.model.fields.create，指定 name、field_description、model_id、ttype='date' 等。
字段的 ttype 值写 'date'；DateTime 则为 'datetime'。state='manual' 表示该字段是手动创建而非模块安装生成，这在自动配置脚本中很常见。
最佳实践要点
实践建议 1：当只需日期时就用 Date 不要用 DateTime
如果业务只关心日历日（截止日、出生年月、到期日等），选择 fields.Date。用 DateTime 会引入不必要的时区复杂性并可能导致日期错位的问题。
实践建议 2：在有意义的地方设置动态默认值
对“预期交期”“跟进日期”等字段，设置默认为今天或今天加若干天，可以给用户一个合理的起点。使用 default=fields.Date.today（不带括号）能确保默认值在记录创建时计算。
实践建议 3：为报告和筛选常用的日期字段加索引
如果用户经常按某个日期字段筛选（逾期发票、即将到期的证书等），加 index=True 会显著提升大数据量下的查询性能，投入小收益大。
实践建议 4：对不应随复制带走的日期用 copy=False
像合同生效日或到期日这类不应在复制记录时沿用的日期，设置 copy=False 强制新建记录时填写新的日期，避免旧日期被无意带入。
实践建议 5：成对的开始/结束日期必须有约束校验
当模型有“开始日期 / 结束日期”这一对字段时，应使用 @api.constrains 加入校验，确保结束日期不早于开始日期，避免后续计算与报表被错误数据破坏。
常见错误与坑
常见的错误：把 Date 和 DateTime 混淆
这是处理时间敏感数据时最常见的失误。DateTime 在数据库中以 UTC 存储并按用户时区显示；Date 只保存日历日。不恰当地用 DateTime 替代 Date 会在跨时区环境中引发“日期前一天/后一天”的问题。
原则：选最简单、能满足业务需求的字段类型。
常见的错误：未考虑服务器时区对定时任务的影响
在按“今天”做过滤的定时任务或报表里，fields.Date.today() 返回的是服务器的 UTC 日期。对大多数场景足够，但在团队跨时区时可能导致一天的偏差。针对全球分布的团队，应从不同时区测试日期相关自动化。
常见的错误：没有对日期区间做校验
很多实现把开始和结束日期作为独立字段放在表单上，却没有校验结束不得早于开始，导致无效数据进入系统，破坏时长计算与筛选结果。遇到这种配对字段一定要加 @api.constrains。
常见的错误：忘记为常用筛选的日期字段建索引
用于“逾期检查”“即将到期”等场景的日期字段常以“date < today”这类条件查询。如果没有索引，每次都是全表扫描。在发票、任务或库存移动等大表上，缺少索引会使日常操作变慢。
常见的错误：把日期作为字符字段存储
有些团队为保留自定义显示格式或回避日历控件，把日期当作 Char 存储。这会破坏排序、筛选、日期运算和报表分析。应始终使用 fields.Date，框架会自动处理好格式化与本地化。
常见问答
问：在 Odoo 中，Date 字段和 DateTime 字段有什么区别？
答：Date 只保存年-月-日，不含时间；DateTime 保存完整时间戳，数据库里以 UTC 存储并在显示时转换到用户时区。若只关心哪一天就用 Date；需精确到时分秒则用 DateTime。
问：如何把默认值设置为“今天”？
答：在 Python 中写 default=fields.Date.today（不要加括号）。这是一个可调用对象，会在记录创建时求值。Studio 中可在字段属性里直接选择“Today”作为默认。
问：能基于其他字段计算日期吗？
答：可以。把字段设为 compute='_compute_my_date'，并用 @api.depends 列出触发计算的字段。在方法中用 datetime.date 或 timedelta 做日期运算，若需用于搜索或分组，记得加 store=True 把结果存库。
问：如何在域（domain）中按日期区间筛选记录？
答：用常规比较运算符。例如筛选 2026 年 3 月内的记录：
（示例域）['x_date_field','>=','2026-03-01'],['x_date_field','<=','2026-03-31']
在域中使用的日期字符串应为 ISO 格式：YYYY-MM-DD。
问：能否在特定条件下把日期字段设为必填？
答：Odoo 原生不支持仅靠视图属性在后端强制条件必填。可以用 view 的 attrs 做前端必填提示，但真正的后端强制需要用 @api.constrains 在 Python 里实现。对于简单需求，Odoo Studio 的条件可见和必填设置能作为实用替代方案。
结语
总结要点
日期字段是 Odoo 中最实用的字段类型之一：概念简单、使用直观，却能驱动提醒、逾期检测和时间敏感报表等关键业务流程。关键记忆点是：只需要日历日就用 Date，不要滥用 DateTime；合理设置默认值与索引能改善用户体验与性能；成对日期务必加约束校验。
小结：构建清晰的数据模型从正确选择字段类型开始。早期把这些细节做好，会让整个 Odoo 项目更稳健、易维护。日期字段是基础但关键的一环。
如果你需要 Odoo 实施、定制或性能优化方面的帮助，我们的团队可以协助从数据模型设计到完整模块交付的各个环节。 联系我们获取支持 让我们聊聊你的 Odoo 项目需求。