# 飞书多维表格字段类型完整参考

## 基础字段

### 1. 文本 (Text)
- 类型ID: 1
- 数据格式: `"任意文本字符串"`
- 示例: `"张三"`, `"这是一段备注"`
- 限制: 最长 32000 字符

### 2. 数字 (Number)
- 类型ID: 2
- 数据格式: `123` 或 `123.45`
- 属性: 可设置小数位、货币格式、百分比
- 示例: `99.9`, `1000000`

### 3. 单选 (SingleSelect)
- 类型ID: 3
- 数据格式: `"选项名称"` （必须是预设选项之一）
- 示例: `"已完成"`, `"进行中"`, `"高优先级"`

### 4. 多选 (MultiSelect)
- 类型ID: 4
- 数据格式: `["选项A", "选项B"]` 数组
- 示例: `["技术部", "产品部"]`, `["Python", "JavaScript"]`

### 5. 日期时间 (DateTime)
- 类型ID: 5
- 数据格式: Unix 毫秒时间戳
- 示例: `1715040000000` (2026-05-07 00:00:00)
- 转换: `new Date("2026-05-07").getTime()`

### 7. 复选框 (Checkbox)
- 类型ID: 7
- 数据格式: `true` 或 `false`

### 11. 人员 (User)
- 类型ID: 11
- 数据格式: `[{"id": "ou_xxxx"}]` 或 `[{"id": "user_id_xxx"}]`
- 支持 open_id / user_id / union_id

### 13. 手机号 (Phone)
- 类型ID: 13
- 数据格式: `"13812345678"` 字符串

### 15. 链接 (URL)
- 类型ID: 15
- 数据格式: `{"text": "显示文字", "link": "https://example.com"}`

### 17. 附件 (Attachment)
- 类型ID: 17
- 数据格式: `[{"file_token": "xxx"}]` 文件token数组
- 需要先上传文件获取 token

### 18. 单向关联 (SingleLink)
- 类型ID: 18
- 数据格式: `{"table_id": "xxx", "record_ids": ["recxxx"]}`
- 关联到其他表的记录

### 21. 双向关联 (DuplexLink)
- 类型ID: 21
- 数据格式: 类似单向关联
- 两表同步关联

### 22. 位置 (Location)
- 类型ID: 22
- 数据格式: `{"location": {"latitude": 39.9, "longitude": 116.4}}`

### 23. 群聊 (GroupChat)
- 类型ID: 23
- 数据格式: `{"chat_id": "oc_xxx"}`

---

## 系统字段（只读）

| 类型ID | 名称 | 说明 |
|--------|------|------|
| 1001 | 创建时间 | 自动生成 |
| 1002 | 修改时间 | 自动更新 |
| 1003 | 创建人 | 自动生成 |
| 1004 | 修改人 | 自动更新 |
| 1005 | 自动编号 | 自增序列 |

---

## 常用时间戳转换

```javascript
// 日期 → 毫秒
Date.parse("2026-05-07") // 或 new Date("2026-05-07").getTime()

// 毫秒 → 日期
new Date(1715040000000).toISOString() // "2026-05-07T00:00:00.000Z"

// 中国时区 (+8)
new Date(1715040000000).toLocaleString("zh-CN")
```