# 日期时间控件 ## 目录 - [日期选择 (datePicker)](#日期选择-datepicker) - [时间选择 (timePicker)](#时间选择-timepicker) --- ## 日期选择 (datePicker) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `datePicker` | | AIBridge builder | `build_field_model(..., jnpf_key="datePicker")` | | 源码示例 | `extend/formDemo/fieldForm1/index.vue` | | workSystem 示例 | 几乎所有业务表单 | ### 基本规则 1. **必填配置**: - `field_name`: 字段中文名称 - `field_vmodel`: 字段 vModel - `jnpf_key`: `"datePicker"` 2. **特有配置**: - `format`: 显示格式 (默认 `"yyyy-MM-dd"`) - `valueFormat`: 值格式 (默认 `"yyyy-MM-dd"`) ### AIBridge 使用 ```python # 基础日期选择 field = build_field_model( field_name="出生日期", field_vmodel="f_birth_date", jnpf_key="datePicker", required=True ) # 自定义格式 (如需显示年月日) field = build_field_model( field_name="入职日期", field_vmodel="f_entry_date", jnpf_key="datePicker", format="yyyy-MM-dd", valueFormat="yyyy-MM-dd" ) ``` ### 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")` | ### 基本规则 1. **特有配置**: - `format`: 显示格式 (默认 `"HH:mm:ss"`) - `valueFormat`: 值格式 (默认 `"HH:mm:ss"`) ### AIBridge 使用 ```python # 时间选择 field = build_field_model( field_name="上班时间", field_vmodel="f_work_start_time", jnpf_key="timePicker" ) # 范围时间 (需两个字段) start_time = build_field_model( field_name="开始时间", field_vmodel="f_start_time", jnpf_key="timePicker" ) end_time = build_field_model( field_name="结束时间", field_vmodel="f_end_time", jnpf_key="timePicker" ) ``` --- ## 日期相关高级控件 ### 移动端特有 | 控件 | jnpfKey | 说明 | |------|---------|------| | DateRange | dateRange | 日期范围选择 | | TimeRange | timeRange | 时间范围选择 | | NumberRange | numberRange | 数字范围 | ### 计算类 | 控件 | jnpfKey | 说明 | workSystem 示例 | |------|---------|------|-----------------| | DateCalculate | dateCalculate | 日期计算 | - | | Calculate | calculate | 通用计算 | 水电费用 (#25), 采购合同 (#28) | --- ## 通用配置说明 ### format 和 valueFormat ```python # 常见格式组合 # 1. 标准日期 (最常用) field = build_field_model( field_name="日期", field_vmodel="f_date", jnpf_key="datePicker", format="yyyy-MM-dd", valueFormat="yyyy-MM-dd" ) # 2. 仅时间 field = build_field_model( field_name="时间", field_vmodel="f_time", jnpf_key="timePicker", format="HH:mm:ss", valueFormat="HH:mm:ss" ) ``` ### 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**: 控制数据存储格式(提交到数据库的) ```python # 显示日期,存储日期字符串 field = build_field_model( field_name="日期", field_vmodel="f_date", jnpf_key="datePicker", format="yyyy-MM-dd", valueFormat="yyyy-MM-dd" ) ``` ### 数据库字段要求 | 控件 | 建议字段类型 | 说明 | |------|------------|------| | datePicker | `varchar(20)` | 如 "2026-04-07" | | datePicker (时间戳) | `bigint` | 毫秒时间戳 | | timePicker | `varchar(10)` | 如 "14:30:00" | --- ## 下一步 - [上传控件](05-upload-controls.md) - [弹窗控件](06-popup-controls.md) - [子表格控件](07-table-controls.md)