# 时间选择器 `picker_time`

提供时间选项的交互组件，默认拥有交互能力。**Card 2.0**。

## 最小示例

```json
{
  "tag": "picker_time",
  "placeholder": { "tag": "plain_text", "content": "请选择" },
  "initial_time": "09:00"
}
```

## 字段

| 字段 | 必填 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
| `tag` | 是 | String | / | 固定 `picker_time` |
| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
| `initial_time` | 否 | String | / | 初始值，格式 `HH:mm`，会覆盖 `placeholder` |
| `placeholder` | 否 | Object | / | 占位文本，plain_text；未设 `initial_time` 时必填 |
| `width` | 否 | String | default | `default`/`fill`/`[100,∞)px` |
| `disabled` | 否 | Boolean | false | 是否禁用（需端版本 V7.4+） |
| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
| `margin` | 否 | String | 0 | [-99,99]px |

## 嵌套 / 易错点

- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / 交互容器内；搭建工具中暂不支持嵌套在交互容器中。
- 提醒用户注意时区语境；服务端只返回用户当前时区作为参考，不代表用户选的就是该时区。
- 回调：`action.tag="picker_time"` + `action.option`（时间字符串，如 `"05:05 +0800"`）+ `action.timezone`；form 内则读 `form_value[name]`。