日期时间控件
目录
日期选择 (datePicker)
基本信息
| 属性 |
值 |
| jnpfKey |
datePicker |
| AIBridge builder |
build_field_model(..., jnpf_key="datePicker") |
| 源码示例 |
extend/formDemo/fieldForm1/index.vue |
| workSystem 示例 |
几乎所有业务表单 |
基本规则
-
必填配置:
field_name: 字段中文名称
field_vmodel: 字段 vModel
jnpf_key: "datePicker"
-
特有配置:
format: 显示格式 (默认 "yyyy-MM-dd")
valueFormat: 值格式 (默认 "yyyy-MM-dd")
AIBridge 使用
workSystem 示例
| 表单名称 |
表单ID |
用途 |
| 员工培训 |
624164673918337925 |
培训日期 |
| 入职申请 |
624163990351643525 |
入职日期 |
| 劳动合同续签 |
623425065425305605 |
合同日期 |
| 离职交接表 |
623417538411233285 |
离职日期 |
| 离职员工表 |
623183958128984261 |
离职日期 |
| 离职申请 |
623163301152424133 |
申请日期 |
| 列表行内编辑 |
585824111083652229 |
日期编辑 |
| 多语言采购申请 |
585448937427567365 |
采购日期 |
| 采购申请 |
585441013829468933 |
申请日期 |
| 物资申请 |
585436888639210245 |
申请日期 |
| 代码对比 |
585436444760212229 |
日期字段 |
| 付款申请 |
585398402720727621 |
付款日期 |
| 套打示例 |
585384793399624261 |
制单日期 |
| 水电费用 |
585110234985398597 |
费用日期 |
| 报价信息 |
585107422926864709 |
报价日期 |
| 个人信息 |
585101489710563653 |
生日 |
| 采购合同 |
585077579715707205 |
签订日期 |
| 订单示例 |
469133201755925637 |
订单日期 |
| 预算管理 |
469100392253286789 |
预算期间 |
| 出差管理 |
469066996185622917 |
出差日期 |
| 事件管理 |
469065268790880645 |
发生日期 |
| 设备巡检管理 |
469062048563652997 |
巡检日期 |
| 核酸检测 |
469038006062344581 |
检测日期 |
| 药房管理 |
468849844170057541 |
日期字段 |
| 报名管理外链 |
468848215723140933 |
报名日期 |
| 大客户信息 |
468842471892247429 |
签约日期 |
常见问题
| 问题 |
原因 |
解决 |
| 保存后显示时间戳 |
valueFormat 不对 |
确认 valueFormat: "yyyy-MM-dd" |
| 日期显示 NaN |
format 不匹配 |
确认 format: "yyyy-MM-dd" |
时间选择 (timePicker)
基本信息
| 属性 |
值 |
| jnpfKey |
timePicker |
| AIBridge builder |
build_field_model(..., jnpf_key="timePicker") |
基本规则
- 特有配置:
format: 显示格式 (默认 "HH:mm:ss")
valueFormat: 值格式 (默认 "HH:mm:ss")
AIBridge 使用
日期相关高级控件
移动端特有
| 控件 |
jnpfKey |
说明 |
| DateRange |
dateRange |
日期范围选择 |
| TimeRange |
timeRange |
时间范围选择 |
| NumberRange |
numberRange |
数字范围 |
计算类
| 控件 |
jnpfKey |
说明 |
workSystem 示例 |
| DateCalculate |
dateCalculate |
日期计算 |
- |
| Calculate |
calculate |
通用计算 |
水电费用 (#25), 采购合同 (#28) |
通用配置说明
format 和 valueFormat
format 格式字符串
| 格式 |
说明 |
示例 |
| yyyy |
4位年份 |
2024 |
| MM |
2位月份 |
01-12 |
| dd |
2位日期 |
01-31 |
| HH |
24小时 |
00-23 |
| mm |
分钟 |
00-59 |
| ss |
秒 |
00-59 |
valueFormat 选项
| 值 |
说明 |
yyyy-MM-dd |
日期字符串 (默认) |
yyyy-MM-dd HH:mm:ss |
完整时间字符串 |
timestamp |
毫秒时间戳 |
数据存储规律
日期时间控件存储规律
| 控件 |
jnpfKey |
存储类型 |
存储格式示例 |
说明 |
| 日期选择 |
datePicker |
字符串 |
"2026-04-07" |
取决于 valueFormat 配置 |
| 时间选择 |
timePicker |
字符串 |
"14:30:00" |
固定字符串格式 |
valueFormat 配置说明
| valueFormat |
存储示例 |
说明 |
yyyy-MM-dd |
"2026-04-07" |
日期字符串 (默认) |
yyyy-MM-dd HH:mm:ss |
"2026-04-07 14:30:00" |
完整时间字符串 |
timestamp |
1744051200000 |
毫秒时间戳(13位) |
format vs valueFormat
- format: 控制前端显示格式(用户看到的)
- valueFormat: 控制数据存储格式(提交到数据库的)
数据库字段要求
| 控件 |
建议字段类型 |
说明 |
| datePicker |
varchar(20) |
如 "2026-04-07" |
| datePicker (时间戳) |
bigint |
毫秒时间戳 |
| timePicker |
varchar(10) |
如 "14:30:00" |
下一步