根本原因是未分清Formatter、DateFormatter和表单控件的职责边界：Formatter用于视图格式化需判空处理，DateFormatter底层将null转当前时间；CJuiDatePicker中dateFormat管提交格式、altFormat仅控制显示；时区需统一PHP、MySQL及Yii配置。
Yii 框架里时间显示不一致、null 值变当前日期、前端控件格式和数据库存值对不上——根本原因不是“不会写”，而是没分清 Formatter、DateFormatter 和表单控件三者的职责边界。
用 Formatter 格式化视图中的时间字符串
这是最常用也最容易出错的场景：你在 CGridView 或视图模板里直接调用 Yii::app()->dateformatter->format()，结果 null 值自动变成当前日期（比如显示 “sysdate”）。
-
Yii::app()->dateformatter->format("Y-m-d", $timestamp)底层会把false或null当作当前时间处理，这不是 bug，是设计行为 - 正确做法是先判空，再格式化：
$data->created ? Yii::app()->dateformatter->format("Y-m-d", strtotime($data->created)) : '' - 更推荐在模型中定义 getter：
public function getCreatedFormatted() { return $this->created ? date("Y-m-d", strtotime($this->created)) : ''; }，然后在视图中直接用$data->createdFormatted - 如果项目已大量使用
CFormatter，可继承并重写formatDate()方法，在内部加空值拦截逻辑
CJuiDatePicker 的 dateFormat 和 altFormat 到底谁管存、谁管显
很多人改了 dateFormat 发现数据库存的还是 Y-m-d，或者界面显示成 04/19/2026 却存不进 MySQL —— 因为没理解这两个参数的分工。
-
dateFormat是 jQuery UI 传给后端的提交格式，必须和 PHP 接收逻辑匹配；例如设为"yy-mm-dd"，POST 过来的值就是"2026-04-19"，PHP 可直接塞进 DATETIME 字段 -
altFormat是纯前端显示格式，不影响提交值；设为"dd M yy"，用户看到 “19 Apr 2026”，但提交的仍是"2026-04-19" - 若数据库字段是
TIMESTAMP，注意 MySQL 会自动转时区；建议统一用DATETIME+ PHP 层控制时区（date_default_timezone_set("Asia/Shanghai")） - 不要在
htmlOptions里加value属性覆盖模型值，会导致表单回显失败
显示“刚刚”“3 小时前”这类相对时间，别硬套 Formatter
Yii 自带的 Formatter 不提供相对时间格式化方法，强行在 formatDatetime() 上打补丁容易污染全局行为。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 新建一个独立 helper 类，比如
TimeAgoHelper::format($timestamp)，只做判断和计算，不依赖组件生命周期 - 关键逻辑要处理时区偏移：
$second = time() - (int)$timestamp，但前提是$timestamp本身是 UTC 时间戳；如果来自 MySQLDATETIME字段，得先用strtotime($row['created'])转换 - 避免在循环渲染大量数据时频繁调用
time()，可提前缓存基准时间：$now = time(); foreach ($items as $item) { echo TimeAgoHelper::format($item['created'], $now); } - 注意 PHP
time()返回的是 int，而 MySQLUNIX_TIMESTAMP()也是 int，两者可直接比较，不用再strtotime()
Yii2 中 yii\i18n\Formatter 的 datetime 格式别名陷阱
迁移到 Yii2 后，有人照搬 Yii1 的写法用 Yii::$app->formatter->asDateTime($time)，却发现输出带时区或格式错乱。
-
asDateTime默认走php:Y-m-d H:i:s，但实际受defaultTimeZone和timeZone配置影响；比如'timeZone' => 'UTC'会导致所有时间被转成 UTC 输出 - 安全写法是显式指定格式：
Yii::$app->formatter->asDateTime($time, 'php:Y-m-d H:i')，绕过 i18n 解析链 - 如果用
short/medium等别名（如asDate($time, 'short')），输出取决于当前语言包，中文环境可能出 “2026/4/19”，英文是 “4/19/2026”，不适合结构化展示 - 数据库读出的
DATETIME字符串，必须先转为 timestamp 或DateTime对象才能被Formatter正确识别，否则会当成字符串原样输出
真正麻烦的从来不是“怎么写出来”，而是当 created_at 在数据库里是 2026-04-19 02:08:00，页面上却显示成 “2026-04-18 18:08:00” 时，你得同时检查 MySQL 时区、PHP date_default_timezone_set、Yii timeZone 配置、以及 jQuery DatePicker 的 dateFormat 是否和后端解析逻辑咬合——漏掉任意一环，时间就悄悄偏移了。
