TP5中应使用PHP原生date()配合strtotime()或think\helper\Date类，而非不存在的formatDateTime()；需根据时间变量类型（时间戳、字符串或DateTime对象）选择对应处理方式，并注意判空、时区及模板安全调用。
TP5里用date()还是formatDateTime()？
TP5本身没有叫formatDateTime()的内置函数，别被某些文档误导。最直接、最可控的方式就是用PHP原生date()配合strtotime()，或者用think\helper\Date类（需手动引入）。框架层只在模板和查询构造中做了少量自动格式化，不提供通用日期处理函数。
常见错误：在控制器里写$time->format('Y-m-d')却没确认$time是DateTime对象——它大概率只是个时间戳或字符串，直接调用会报Call to a member function format() on int/string。
- 如果变量是时间戳（如
$create_time = 1623456789），直接用date('Y-m-d H:i:s', $create_time) - 如果是标准日期字符串（如
'2021-06-12 14:30:00'），先转时间戳：date('Y-m-d', strtotime($str)) - 如果已用
DateTime类实例化（如new \DateTime($str)），才可用->format()
在模型或控制器里封装一个复用的格式化方法
硬编码date()容易散落各处、格式不统一。推荐在基类或助手函数里定义一个简单封装：
// app/common.php 或 app/traits/TimeFormatTrait.php
function format_date($time, $format = 'Y-m-d H:i:s') {
if (empty($time)) return '';
$ts = is_numeric($time) ? (int)$time : strtotime($time);
return $ts === false ? '' : date($format, $ts);
}
这样在控制器里就能直接写format_date($user['create_time'], 'Y年m月d日')。注意strtotime()对非标准格式（如'2021/06/12'）兼容性好，但对'12-06-2021'这种可能解析错月份——TP5不干预这个行为，得靠输入规范或预处理。
- 避免在
select()里直接套date_format()（MySQL函数），会导致索引失效；应尽量在PHP层格式化 - 如果字段是
datetime类型且值为NULL，strtotime(null)返回false，date()会输出1970年，必须判空
模板里用date标签还是think:date？
TP5模板引擎支持两种写法：{:$create_time|date='Y-m-d'}（原生PHP函数）或{:date('Y-m-d', $create_time)}。别用{:think:date($create_time,'Y-m-d')}——这是早期文档残留，TP5.1+已移除该函数。
坑点在于：模板里的$create_time如果是NULL或空字符串，date()会警告并返回False，页面显示False字面量。稳妥写法是加默认值：
{:$create_time|default=''|date='Y-m-d H:i:s'}
-
|default=''必须放在|date=前面，顺序反了无效 - 模板里不建议用复杂逻辑，比如带时区转换，应提前在控制器处理好
- 如果项目开了
timezone配置（如'Asia/Shanghai'），date()会自动按该时区输出，不用额外调date_default_timezone_set()
时区不准、时间比预期快8小时怎么办？
本质不是TP5的问题，而是PHP环境时区未设或数据库存的是UTC时间。检查三处：
- PHP配置：
phpinfo()看date.timezone是否为Asia/Shanghai；没设就改php.ini或运行时加date_default_timezone_set('Asia/Shanghai') - 数据库连接配置：TP5的
database.php里确认'params' => [\PDO::ATTR_EMULATE_PREPARES => true]没关掉时区自动转换（一般不用动） - 数据本身：如果MySQL字段类型是
timestamp，它会按服务器时区存取；而datetime是纯字符串存储，TP5读出来后全靠PHP解释——所以存datetime更可控
最易忽略的一点：前端传来的ISO格式时间（如'2021-06-12T14:30:00.000Z'）含Z表示UTC，strtotime()会按本地时区转，结果偏移8小时。得先去掉Z或显式指定时区：new \DateTime($str, new \DateTimeZone('UTC'))再->setTimezone(new \DateTimeZone('Asia/Shanghai'))。
