PHP/Laravel中处理时间字符串并计算总时长的教程

<?php

/**
 * 将 H:i:s 格式的时间字符串转换为总秒数
 *
 * @param string $durationString 持续时间字符串，例如 "00:02:53"
 * @return int 总秒数
 */
function timeStringToSeconds(string $durationString): int
{
    // 使用冒号分割字符串，得到小时、分钟和秒
    $parts = explode(':', $durationString);

    // 确保有三个部分（小时、分钟、秒），否则处理可能不完整的格式
    if (count($parts) < 3) {
        // 尝试处理 i:s 格式，假设小时为0
        if (count($parts) == 2) {
            $h = 0;
            $m = (int)$parts[0];
            $s = (int)$parts[1];
        } else {
            // 如果格式不符合预期，返回0或抛出异常
            return 0;
        }
    } else {
        $h = (int)$parts[0]; // 小时
        $m = (int)$parts[1]; // 分钟
        $s = (int)$parts[2]; // 秒
    }

    // 计算总秒数
    return ($h * 3600) + ($m * 60) + $s;
}

// 示例用法
// echo timeStringToSeconds("00:02:53"); // 输出 173
// echo timeStringToSeconds("01:00:00"); // 输出 3600
?>

<?php

// 假设 $queuelist 是从数据库查询出来的歌曲列表
// 每个 $song 对象都有一个 duration 属性，例如 "00:02:53"
$queuelist = [
    (object)['duration' => '00:02:53'],
    (object)['duration' => '00:03:10'],
    (object)['duration' => '00:01:45'],
    (object)['duration' => '01:05:00'], // 包含小时的示例
];

$totalQueueSeconds = 0;

foreach ($queuelist as $song) {
    // 调用前面定义的函数，将每首歌的持续时间转换为秒数并累加
    $totalQueueSeconds += timeStringToSeconds($song->duration);
}

// 此时 $totalQueueSeconds 包含了所有歌曲的总秒数
// 例如，对于上面的示例数据，它将是 173 + 190 + 105 + 3900 = 4368 秒

?>

<?php

/**
 * 将总秒数转换为 M:S 或 MM:SS 格式的字符串
 *
 * @param int $totalSeconds 总秒数
 * @return string 格式化的时间字符串，例如 "02:53"
 */
function secondsToMinutesSeconds(int $totalSeconds): string
{
    // 计算总分钟数
    $minutes = floor($totalSeconds / 60);
    // 计算剩余秒数
    $seconds = $totalSeconds % 60;

    // 使用 sprintf 格式化输出，确保分钟和秒都是两位数（如果需要）
    // 例如，如果需要 "2:53" 而不是 "02:53"，可以省略 %02d 中的 0
    return sprintf('%02d:%02d', $minutes, $seconds);
    // 如果需要 "2:53" 这种不带前导零的分钟格式，可以使用：
    // return sprintf('%d:%02d', $minutes, $seconds);
}

// 示例用法
// 假设 $totalQueueSeconds = 4368
// echo secondsToMinutesSeconds($totalQueueSeconds); // 输出 "72:48"
// echo secondsToMinutesSeconds(173); // 输出 "02:53"
?>

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
// 假设您有 Song 模型
// use App\Models\Song;

class JukeboxController extends Controller
{
    /**
     * 将 H:i:s 格式的时间字符串转换为总秒数
     *
     * @param string $durationString 持续时间字符串，例如 "00:02:53"
     * @return int 总秒数
     */
    private function timeStringToSeconds(string $durationString): int
    {
        $parts = explode(':', $durationString);
        if (count($parts) < 3) {
            if (count($parts) == 2) { // 假设是 i:s 格式
                $h = 0;
                $m = (int)$parts[0];
                $s = (int)$parts[1];
            } else {
                return 0; // 无效格式
            }
        } else {
            $h = (int)$parts[0];
            $m = (int)$parts[1];
            $s = (int)$parts[2];
        }
        return ($h * 3600) + ($m * 60) + $s;
    }

    /**
     * 将总秒数转换为 M:S 或 MM:SS 格式的字符串
     *
     * @param int $totalSeconds 总秒数
     * @return string 格式化的时间字符串，例如 "02:53"
     */
    private function secondsToMinutesSeconds(int $totalSeconds): string
    {
        $minutes = floor($totalSeconds / 60);
        $seconds = $totalSeconds % 60;
        return sprintf('%02d:%02d', $minutes, $seconds);
    }

    /**
     * 获取播放队列的总时长
     *
     * @return string 格式化的总时长，例如 "72:48"
     */
    public function getQueueTotalDuration(): string
    {
        // 实际应用中，这里会从数据库获取歌曲列表
        // $queuelist = Song::all(); // 示例：获取所有歌曲

        // 模拟数据
        $queuelist = [
            (object)['duration' => '00:02:53'],
            (object)['duration' => '00:03:10'],
            (object)['duration' => '00:01:45'],
            (object)['duration' => '01:05:00'],
            (object)['duration' => '00:00:05'], // 5秒
        ];

        $totalQueueSeconds = 0;

        foreach ($queuelist as $song) {
            $totalQueueSeconds += $this->timeStringToSeconds($song->duration);
        }

        return $this->secondsToMinutesSeconds($totalQueueSeconds);
    }
}

// 假设在路由中调用：
// Route::get('/queue-duration', [JukeboxController::class, 'getQueueTotalDuration']);
// 访问 /queue-duration 可能会输出 "72:53" (基于示例数据)

?>