车间考核系统文档

外观

默认当前日期

复制页面

约 834 字大约 3 分钟

2026-08-18

原理说明

在 YonBuilder 应用构建中，为实体日期字段配置默认值为当前日期，可以在新增数据时自动填充日期，减少手动录入。核心方法是：在实体建模时，为日期字段的"默认值"属性配置公式，以获取系统当前日期并格式化为所需格式。

格式一致性

若日期字段存储了带时分秒的数据（如 yyyy-MM-dd HH:mm:ss），但在查询时仅使用日期部分（yyyy-MM-dd）进行区间匹配，可能导致查询失败。因此配置默认当前日期时，必须确保其格式与字段的存储和查询预期一致。

配置步骤

1. 进入实体建模

登录 YonBuilder 开发环境，进入目标应用，找到对应的实体并进入设计器。

2. 定位日期字段

在实体属性列表中，找到类型为"日期"的字段（例如 start_date、end_date 或 inspect_date）。

3. 配置默认值公式

选中该日期字段，在右侧属性面板中找到"默认值"设置项：

  • 不要使用简单的 sysdate()，因为它返回包含时分秒的完整日期时间
  • 应使用以下公式：
dateFormat(sysdate(),'yyyy-MM-dd')

公式说明：

函数/参数作用
sysdate()获取系统当前日期和时间
dateFormat(...)将日期格式化为指定的字符串格式
'yyyy-MM-dd'目标格式，表示"年-月-日"，不包含时分秒

4. 保存并发布

完成配置后，保存实体修改，并发布实体以使更改生效。

关联场景：查询区日期区间

如果该日期字段后续需要在查询区作为"日期区间"条件使用，且需要准确查询，还需在页面设计器中对该查询区字段增加 bStringAttribute: true 属性。这确保了在查询时，日期值以字符串形式进行比较，避免因时间部分导致的匹配问题。

注意事项

  1. 格式一致性：务必使用 dateFormat(sysdate(),'yyyy-MM-dd') 而非 sysdate()。后者包含时分秒，会导致仅按日期进行的区间查询或匹配出现异常。
  2. 存储与查询匹配：此配置确保字段存储的是纯日期字符串。如果字段本身定义为"日期时间"类型且存储了时间，则此方法可能不适用，需要根据业务需求调整字段类型或处理逻辑。
  3. 公式大小写：公式函数名（如 dateFormat、sysdate）通常不区分大小写，但建议与文档示例保持一致。
  4. 发布生效：修改实体默认值后，必须执行发布操作，新的默认值规则才会在运行时生效。

参考来源

修改记录

版本日期修改人修改内容
1.02026/08/18—初始版本：整理自官方知识库文档

更新日志

2026/8/18 19:24
查看所有更新日志
  • 1500f-feat: 新增开发指南模块、修复mermaid显示与图标问题于