问题描述与挑战
在处理包含多个营业时间段的数组时，常见需求是将所有时间段连接起来显示，例如：“今日营业时间：9:00-9:45, 9:55-10:20, 10:30-11:00”。这通常通过遍历数组并使用 join 函数实现。原始代码片段展示了这种处理方式：
$ranges = [
['from' => '9:00', 'to' => '9:45'],
['from' => '9:55', 'to' => '10:20'],
['from' => '10:30', 'to' => '11:00'],
];
// 原始处理方式：格式化并连接所有时间段
$formatted_ranges = array_map(function($range) {
// 假设存在一个 format_time 方法将时间格式化为 H:i
return $this->format_time($range['from']) . ' - ' . $this->format_time($range['to']);
}, $ranges);
// 输出：Open hours today: 9:00 - 9:45, 9:55 - 10:20, 10:30 - 11:00
return sprintf(
__('Open hours today:', 'example') . ' %s',
join(', ', $formatted_ranges)
);然而，实际需求可能并非如此。有时，我们只需要展示整体的营业时间范围，即从最早的开始时间到最晚的结束时间，忽略中间的间断。例如，对于上述时间段，我们期望的输出是：“今日营业时间：9:00 - 11:00”。
尝试使用 array_key_first($formatted_ranges) 只能获取第一个格式化后的时间段（例如 "9:00 - 9:45"），这不符合获取整体范围的要求。核心挑战在于，如何在不遍历所有时间段并连接它们的情况下，高效地提取出这个整体的起始和结束时间。
核心解决方案：直接访问首尾元素
解决这个问题的关键在于，理解“整体营业时间范围”的定义。它由第一个营业时段的开始时间，以及最后一个营业时段的结束时间共同决定。因此，我们无需处理或格式化数组中的所有中间时间段，只需直接访问原始 $ranges 数组的第一个元素的 from 值和最后一个元素的 to 值即可。
这种方法具有以下优点：
立即学习“PHP免费学习笔记（深入）”；
- 高效性：操作复杂度为 O(1)，无论数组包含多少时间段，提取操作的耗时都是恒定的。
- 简洁性：代码量显著减少，逻辑更加清晰。
- 精确性：直接获取所需的边界值，避免了因中间处理可能引入的复杂性。
代码实现与解析
以下是实现上述解决方案的PHP代码示例：
'9:00', 'to' => '9:45'],
['from' => '9:55', 'to' => '10:20'],
['from' => '10:30', 'to' => '11:00'],
];
/**
* 提取并格式化整体营业时间范围
*
* @param array $ranges 包含时间段的数组，每个元素如 ['from' => 'H:i', 'to' => 'H:i']
* @return string 格式化的营业时间字符串，或错误信息
* @throws Exception 当数据不足时抛出异常
*/
function getOverallBusinessHours(array $ranges): string
{
// 1. 数据有效性检查
// 确保数组不为空，并且第一个元素包含 'from' 和 'to' 键
if (empty($ranges) || !isset($ranges[0]['from'], $ranges[0]['to'])) {
throw new Exception('业务时间数据不足或格式不正确。');
}
// 2. 获取最早的开始时间
// 直接访问数组的第一个元素（索引为0）的 'from' 键
$firstStartTime = $ranges[0]['from'];
// 3. 获取最晚的结束时间
// 使用 array_key_last() 获取数组最后一个元素的键，然后访问其 'to' 键
// array_key_last() 在 PHP 7.3+ 版本可用
$lastEndTime = $ranges[array_key_last($ranges)]['to'];
// 4. 格式化并输出结果
// 使用 printf 函数将获取到的起始和结束时间组合成期望的字符串
return sprintf('Open hours today: %s - %s', $firstStartTime, $lastEndTime);
}
try {
echo getOverallBusinessHours($ranges);
// 预期输出: Open hours today: 9:00 - 11:00
} catch (Exception $e) {
echo '错误: ' . $e->getMessage();
}
echo "\n";
// 示例：空数组或无效数据
$emptyRanges = [];
try {
echo getOverallBusinessHours($emptyRanges);
} catch (Exception $e) {
echo '错误: ' . $e->getMessage() . "\n"; // 预期输出: 错误: 业务时间数据不足或格式不正确。
}
$invalidRanges = [
['start' => '9:00', 'end' => '10:00'] // 键名不匹配 'from'/'to'
];
try {
echo getOverallBusinessHours($invalidRanges);
} catch (Exception $e) {
echo '错误: ' . $e->getMessage() . "\n"; // 预期输出: 错误: 业务时间数据不足或格式不正确。
}
?>代码解析：
- 数据有效性检查：在处理任何数据之前，进行验证是良好的编程实践。这里检查了 $ranges 数组是否为空，以及第一个元素是否包含 from 和 to 键，以防止因数据缺失或格式不正确而导致程序崩溃。
- 获取最早的开始时间：通过 $ranges[0]['from'] 直接访问数组的第一个元素，并取出其 from 键对应的值。
- 获取最晚的结束时间：使用 array_key_last($ranges) 获取 $ranges 数组最后一个元素的键（对于数字索引数组，这将是最大的索引）。然后，通过 $ranges[array_key_last($ranges)]['to'] 访问最后一个元素，并取出其 to 键对应的值。
- 格式化输出：sprintf 函数用于将获取到的 firstStartTime 和 lastEndTime 按照指定格式组合成最终的字符串。
注意事项与最佳实践
- 数据完整性与验证：始终对输入数据进行验证。如示例所示，检查数组是否为空以及关键键是否存在，可以有效避免运行时错误。
-
PHP 版本兼容性：array_key_last() 函数是在 PHP 7.3 版本中引入的。如果您的项目运行在更早的 PHP 版本上，您需要采用其他方式来获取最后一个元素的键，例如：
// PHP 7.2 及更早版本获取最后一个元素的键 end($ranges); // 将数组内部指针移到最后一个元素 $lastKey = key($ranges); // 获取当前指针位置的键 reset($ranges); // 可选：将数组内部指针重置回第一个元素 $lastEndTime = $ranges[$lastKey]['to'];
- 时间格式化：本教程示例中，假设 from 和 to 值已经是 H:i 格式的字符串，可以直接用于输出。如果原始数据是其他格式（例如 DateTime 对象或时间戳），您可能需要在提取后使用 DateTime::createFromFormat() 和 format() 方法进行必要的格式化。
- 数组结构一致性：此解决方案假定 $ranges 数组的每个元素都具有一致的 from 和 to 键。确保数据源提供的数据结构符合预期。
- 错误处理：通过 try-catch 块捕获 Exception，可以优雅地处理数据不足或格式错误的情况，提高程序的健壮性。
总结
当需要从一组离散的时间段中提取并展示整体的营业时间范围时，直接访问数组的首个元素的起始时间和最后一个元素的结束时间是一种极为高效且简洁的方法。它避免了不必要的循环和字符串连接操作，显著提升了代码的性能和可读性。通过结合适当的数据验证和PHP版本兼容性考量，您可以构建出既健壮又高效的时间范围处理逻辑。
