Yii框架中API时间戳应统一转为可读格式，推荐在模型fields()中映射格式化字符串、Response Formatter全局处理或返回双字段（时间戳+display），注意时区设UTC及精度适配。
Yii框架中API返回时间戳时，通常需要转换为可读的日期格式，而不是直接暴露原始时间戳。关键在于统一处理逻辑、兼顾性能与可维护性，并适配不同场景（如RESTful API、JSON序列化、数据库字段等）。
在模型中使用 attributeLabels + formatters 自动转换
适合在 ActiveRecord 模型中对创建时间、更新时间等字段做统一格式化输出。Yii2 默认支持 datetime 格式器，只需配置好属性行为即可：
- 在模型的
behaviors()中添加TimestampBehavior确保时间字段自动写入时间戳 - 重写
fields()或extraFields()，将时间戳字段映射为格式化后的字符串 - 示例：public function fields() { $fields = parent::fields(); $fields['created_at'] = function ($model) { return date('Y-m-d H:i:s', $model->created_at); }; return $fields; }
通过 Response Formatter 全局控制 JSON 输出格式
适用于整个应用的API响应统一处理。在 config/web.php 的 response 组件中配置 formatters：
- 启用
'json' => ['class' => 'yii\web\JsonResponseFormatter', 'prettyPrint' => YII_DEBUG] - 结合
Serializer类，在自定义 Serializer 中对时间戳字段做预处理（如遍历数组，识别_at/time结尾字段并转换） - 更稳妥的方式：在控制器基类的
afterAction()中拦截响应数据，批量转换时间戳字段
前端兼容方案：返回双字段（时间戳 + 格式化字符串）
当客户端对时间显示有灵活需求（如多语言、本地时区），建议同时返回原始时间戳和格式化后的时间字符串：
- 避免前端重复解析或时区误差，也保留服务端精确时间依据
- 字段命名建议：如
"created_at": 1717023456和"created_at_display": "2024-05-30 14:57:36" - 可在模型
toArray()方法中统一注入 display 字段，不影响原有业务逻辑
注意时区与时间精度问题
时间戳本身是 UTC 秒数，但 PHP 的 date() 默认使用服务器时区。务必确认：
- PHP 配置
date.timezone是否正确（推荐设为UTC，前端再转本地时间） - 若需毫秒级精度（如 JavaScript
Date.now()），后端应返回round(microtime(true) * 1000)并在 API 文档中明确说明 - 数据库中存储为
INT(11)只能存秒级；如需毫秒，建议用BIGINT或DATETIME(3)
