本文介绍一种专业、健壮的 php 实现方式：先将总秒数统一转换为秒级整数，再基于目标步长（单位：分钟）向上取整到最近倍数，最后格式化为“xh ymin”或“xh ym zs”等易读形式，支持零步长直通、边界对齐及跨小时进位。
本文介绍一种专业、健壮的 php 实现方式：先将总秒数统一转换为秒级整数，再基于目标步长（单位：分钟）向上取整到最近倍数，最后格式化为“xh ymin”或“xh ym zs”等易读形式，支持零步长直通、边界对齐及跨小时进位。
要实现「按分钟步长向上取整 + 格式化输出」这一需求，核心在于统一时间单位与正确向上取整逻辑。原始函数存在多个问题：未处理天数变量 $d 的定义、round() 导致四舍五入而非向上取整、缺乏步长处理逻辑、且时间拆分耦合严重。以下是优化后的完整解决方案：
✅ 推荐实现（模块化、可读性强、符合语义）
/**
* 将总秒数向上取整至指定分钟步长，并格式化为 "Xh Ymin" 形式
* @param int $totalSeconds 总耗时（秒）
* @param int $stepMinutes 步长（分钟），0 表示不取整
* @return string 如 "41h 25min"、"42h 0min" 或 "0min"
*/
function parse_time(int $totalSeconds, int $stepMinutes = 0): string
{
// 若步长为 0，跳过取整
if ($stepMinutes > 0) {
$stepSeconds = $stepMinutes * 60;
// 向上取整：ceil($totalSeconds / $stepSeconds) * $stepSeconds
$totalSeconds = (int) ceil($totalSeconds / $stepSeconds) * $stepSeconds;
}
// 拆分为天、小时、分钟、秒（避免 floor/round 引入误差）
$days = (int) floor($totalSeconds / 86400);
$hours = (int) floor(($totalSeconds % 86400) / 3600);
$minutes = (int) floor(($totalSeconds % 3600) / 60);
$seconds = $totalSeconds % 60;
// 构建非零部分字符串（按天→时→分→秒顺序，仅显示非零项）
$parts = [];
if ($days > 0) $parts[] = $days . 'd';
if ($hours > 0) $parts[] = $hours . 'h';
if ($minutes > 0 || empty($parts)) $parts[] = $minutes . 'min'; // 确保至少显示分钟（如 0h 5min）
// 注：若需显示秒（如精度要求高），可追加：if ($seconds > 0) $parts[] = $seconds . 's';
return implode(' ', $parts) ?: '0min';
}? 使用示例
$base = 41 * 3600 + 20 * 60; // 41h 20min = 148800 秒 echo parse_time($base, 5); // → "41h 25min" echo parse_time($base, 15); // → "41h 30min" echo parse_time($base, 20); // → "41h 20min"（正好整除） echo parse_time($base, 30); // → "41h 30min" echo parse_time($base, 60); // → "42h 0min"（进位到小时） echo parse_time($base, 180); // → "42h 0min"（3 小时步长 → 149400s = 41.5h → 向上取整为 42h） echo parse_time($base, 0); // → "41h 20min"（无取整）
⚠️ 关键注意事项
- 向上取整 ≠ 四舍五入：必须使用 ceil($x / $step) * $step，而非 round() 或 $x - $x % $step + $step（后者在整除时会错误+1步）；
- 单位一致性：所有计算统一用「秒」，避免浮点误差和时区干扰；
- 边界处理：$stepMinutes
- 格式灵活性：当前版本省略秒（除非必要），若需精确到秒，可启用 $seconds 分支并调整逻辑；
- 性能友好：无正则、无 strtotime() 调用，纯数学运算，适合高频调用场景。
该方案兼顾准确性、可维护性与扩展性，适用于工时系统、计费引擎、项目管理后台等对时间精度敏感的业务场景。
