本文介绍在 laravel eloquent 查询中，使用 mysql 的 `date_format()` 函数配合 `db::raw()`，从 datetime 类型字段中精准提取并格式化为“小时:分钟:秒”（如 `14:23:05`）的方法。
在实际开发中，数据库表（如 attendance）的 attendance_time 字段通常为 DATETIME 类型，存储完整的时间戳（例如 '2024-05-20 08:45:32'）。但业务场景常只需展示“时:分:秒”部分（如考勤打卡时间），此时直接 SELECT in.attendance_time AS in_time 会返回完整日期时间，不符合前端简洁展示需求。
Laravel 原生查询构建器不支持对字段进行原生时间格式化，需借助 DB::raw() 调用底层数据库函数。MySQL 提供了强大的 DATE_FORMAT() 函数，可按指定格式截取并格式化时间部分。
✅ 正确做法是：将原 select() 中的 'in.attendance_time as in_time' 替换为：
DB::raw('DATE_FORMAT(in.attendance_time, "%H:%i:%s") as in_time'),
DB::raw('DATE_FORMAT(out.attendance_time, "%H:%i:%s") as out_time')注意：格式符说明：
- %H → 24 小时制小时（00–23）
- %i → 分钟（00–59）
- %s → 秒（00–59）
- 冒号 : 作为分隔符（也可替换为 - 或空格，如 "%H-%i-%s"）
完整修正后的查询片段如下：
$absen = DB::table('attendance as in')
->where('in.in_out', 'in')
->where('in.company_id', \Session::get('selected_company'))
->whereDate('in.created', Carbon::today())
->leftJoin('attendance as out', function ($join) {
$join->on('in.employee_id', 'out.employee_id')
->where('out.in_out', 'out')
->where('out.company_id', \Session::get('selected_company'))
->whereDate('out.created', Carbon::today());
})
->join('employee', 'employee.id', 'in.employee_id')
->join('location_library', 'location_library.id', 'in.attendance_location_id')
->join('company as cp', 'cp.id', 'in.company_id')
->join('employee_in_app as e_app', 'e_app.employee_id', 'in.employee_id')
->join('employee_in_company', 'in.employee_id', 'employee_in_company.employee_id')
->select(
'employee.name',
'cp.alias',
'in.employee_id',
'location_library.location_name',
DB::raw('DATE_FORMAT(in.attendance_time, "%H:%i:%s") as in_time'),
DB::raw('DATE_FORMAT(out.attendance_time, "%H:%i:%s") as out_time'),
'e_app.note'
)
->orderBy('in.attendance_time', 'DESC')
->get();⚠️ 注意事项：
- 此方案依赖 MySQL 数据库；若使用 PostgreSQL，应改用 TO_CHAR(in.attendance_time, 'HH24:MI:SS')；
- DATE_FORMAT() 返回字符串类型，不可再用于时间计算或排序（如需排序原始时间，请保留原始字段或额外 SELECT in.attendance_time）；
- 若字段可能为 NULL（如员工尚未打卡），DATE_FORMAT(NULL, ...) 返回 NULL，符合预期，无需额外处理；
- Laravel 10+ 中确保已正确引入 use Illuminate\Support\Facades\DB;。
通过该方式，既保持了查询性能（格式化在数据库层完成），又精准满足了 UI 层对纯时间格式的展示需求。
