本文介绍如何从包含多个到期日期的 json 数组中，准确筛选出最近的有效到期日期（如 "2022-03"），自动排除占位符 "0000-00"，并通过时间戳转换与排序确保逻辑正确性。
在处理商品批次、库存有效期或金融合约等业务场景时，常需从一组 expiration 字符串（格式为 YYYY-MM）中找出距离当前最近的未来/已临期但有效的到期月份。注意：题中“最近”实际指时间值最小的有效日期（即最早到期的那个，如 2022-03 早于 2023-02），而非字典序最小——因此直接使用 min($item->expiration) 会因字符串比较导致错误（例如 "2022-03"
正确做法是将 YYYY-MM 转换为可比较的时间基准（如 Unix 时间戳），再排序取首个有效项。以下是推荐实现：
function getNearestExp(string $jsonItems): array
{
$items = json_decode($jsonItems, associative: true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new InvalidArgumentException('Invalid JSON input');
}
$validExpirations = [];
foreach ($items as $item) {
$exp = $item['expiration'] ?? '';
// 排除无效占位符
if ($exp === '0000-00' || !preg_match('/^\d{4}-\d{2}$/', $exp)) {
continue;
}
// 转为当月第一天时间戳（确保月份比较准确，避免时区歧义）
$timestamp = strtotime("{$exp}-01");
if ($timestamp === false) {
continue; // 跳过非法日期，如 "2023-13"
}
$validExpirations[$timestamp] = $item;
}
if (empty($validExpirations)) {
throw new RuntimeException('No valid expiration dates found');
}
ksort($validExpirations); // 升序：最早到期的排第一
return array_values($validExpirations)[0];
}
// 使用示例：
$itemsJson = '[{"expiration": "0000-00", "quantity": -50}, {"expiration": "2023-02", "quantity": 100}, {"expiration": "2022-03", "quantity": 50}]';
try {
$nearest = getNearestExp($itemsJson);
print_r($nearest); // 输出: Array ( [expiration] => 2022-03 [quantity] => 50 )
} catch (Exception $e) {
error_log($e->getMessage());
}✅ 关键要点说明：
- 使用 strtotime("YYYY-MM-01") 将月份标准化为该月首日时间戳，规避 strtotime("2022-03") 在部分 PHP 版本中可能返回 false 的风险；
- 严格校验日期格式（正则 /^\d{4}-\d{2}$/）和解析结果，增强鲁棒性；
- 错误处理覆盖 JSON 解析失败、无有效日期等边界情况；
- 返回原始数组结构（非对象），便于后续直接使用 $item['quantity'] 等字段。
⚠️ 注意：若业务语义中“最近”指距离今天最近的未来到期日（即尚未到期但最临近），则需额外过滤 $timestamp >= strtotime('today') 并改用 array_filter() 预筛选，再取 min() —— 本文按题干明确要求（取 2022-03）采用“最早有效到期日”逻辑。
