PHP/Laravel中H:i:s格式时间字符串的汇总与转换教程

/**
 * 将 H:i:s 格式的时间字符串转换为总秒数。
 * 例如："00:02:53" -> 173 秒。
 *
 * @param string $duration 时间字符串，格式为 H:i:s (例如 "00:02:53")
 * @return int 总秒数
 */
function convertDurationToSeconds(string $duration): int
{
    // 使用 sscanf 解析时间字符串。
    // 如果字符串不包含小时部分（例如 "02:53"），sscanf 也能处理。
    // 但为了与 H:i:s 格式严格匹配，建议确保输入总是 H:i:s。
    $parts = explode(':', $duration);
    $seconds = (int)($parts[count($parts) - 1] ?? 0);
    $minutes = (int)($parts[count($parts) - 2] ?? 0);
    $hours = (int)($parts[count($parts) - 3] ?? 0);

    return $hours * 3600 + $minutes * 60 + $seconds;
}

// 示例用法
// echo convertDurationToSeconds("00:02:53"); // 输出 173
// echo convertDurationToSeconds("01:30:00"); // 输出 5400

// 初始化总秒数
$totalQueueSeconds = 0;

// 假设 $queuelist 是一个包含歌曲对象的集合或数组
foreach ($queuelist as $song) {
    // 确保 $song->duration 是一个字符串，例如 "00:02:53"
    $totalQueueSeconds += convertDurationToSeconds($song->duration);
}

// 此时 $totalQueueSeconds 包含了整个队列的总时长（以秒为单位）
// 例如，如果队列总时长为 90 分钟，则 $totalQueueSeconds = 5400

/**
 * 将总秒数格式化为时间字符串。
 *
 * @param int $totalSeconds 总秒数
 * @param bool $includeHours 是否包含小时部分，如果为 false，则分钟数可能大于59
 * @return string 格式化的时间字符串
 */
function formatSecondsToTime(int $totalSeconds, bool $includeHours = false): string
{
    if ($includeHours) {
        // 格式化为 HH:MM:SS
        $hours = floor($totalSeconds / 3600);
        $minutes = floor(($totalSeconds % 3600) / 60);
        $seconds = $totalSeconds % 60;
        return sprintf('%02d:%02d:%02d', $hours, $minutes, $seconds);
    } else {
        // 格式化为 MM:SS，其中 MM 可以超过 59
        $totalMinutes = floor($totalSeconds / 60);
        $remainingSeconds = $totalSeconds % 60;
        return sprintf('%02d:%02d', $totalMinutes, $remainingSeconds);
    }
}

// 示例用法
// 假设 $totalQueueSeconds = 5400 (90分钟)
// echo formatSecondsToTime($totalQueueSeconds, true);  // 输出 "01:30:00"
// echo formatSecondsToTime($totalQueueSeconds, false); // 输出 "90:00" (符合问题中 "2:53" 这种分钟数可超过59的格式)

// 如果 $totalQueueSeconds = 173 (2分53秒)
// echo formatSecondsToTime(173, true);  // 输出 "00:02:53"
// echo formatSecondsToTime(173, false); // 输出 "02:53"

// app/Models/Queue.php (示例模型)
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Queue extends Model
{
    // ... 其他模型属性和方法

    /**
     * 获取队列中所有歌曲的总时长（格式化为 MM:SS）。
     * 假设 'songs' 关系返回所有歌曲。
     *
     * @return string
     */
    public function getTotalDurationFormattedAttribute(): string
    {
        $totalSeconds = $this->songs->sum(function ($song) {
            return convertDurationToSeconds($song->duration); // 假设 $song->duration 是 H:i:s 字符串
        });

        return formatSecondsToTime($totalSeconds, false); // 返回 MM:SS 格式
    }

    /**
     * 获取队列中所有歌曲的总时长（以秒为单位）。
     *
     * @return int
     */
    public function getTotalDurationInSecondsAttribute(): int
    {
        return $this->songs->sum(function ($song) {
            return convertDurationToSeconds($song->duration);
        });
    }
}

// 在控制器或视图中使用
// $queue = Queue::find(1);
// echo $queue->total_duration_formatted; // 输出 "90:00"
// echo $queue->total_duration_in_seconds; // 输出 5400