PHP 处理 JSON：按日期字段分组统计每月数据-php教程-PHP中文网

PHP 处理 JSON：按日期字段分组统计每月数据

碧海醫心

发布： 2025-09-27 09:20:33

原创

453人浏览过

PHP 处理 JSON：按日期字段分组统计每月数据

本教程旨在指导如何使用 PHP 有效地解析 JSON 格式的数据，并根据其中的日期字段（如 Start_Date）进行筛选和统计，最终按月份聚合数据量。文章将涵盖 JSON 解码、数据遍历、日期格式转换及高效计数的核心步骤，帮助开发者从复杂的 JSON 结构中提取并汇总所需信息。

1. 理解 JSON 数据结构

在处理从 api 或其他源获取的 json 数据时，首先需要明确其内部结构。本教程使用的 json 示例如下，其中核心业务数据嵌套在 response.data 路径下。data 数组包含多个记录项，每项通过 fielddata 对象存储具体字段，而 start_date 则是我们进行统计的日期字段。

{
    "response": {
        "dataInfo": {
            "foundCount": 494,
            "returnedCount": 4
        },
        "data": [
            {
                "fieldData": {
                    "Closed_Date": "10/03/2021",
                    "Start_Date": "10/03/2021"
                },
                "portalData": {},
                "recordId": "152962",
                "modId": "3"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/14/2021",
                    "Start_Date": "11/06/2021"
                },
                "portalData": {},
                "recordId": "153228",
                "modId": "22"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/07/2021",
                    "Start_Date": "11/06/2021"
                },
                "portalData": {},
                "recordId": "153329",
                "modId": "7"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/08/2021",
                    "Start_Date": "11/08/2021"
                },
                "portalData": {},
                "recordId": "153513",
                "modId": "3"
            }
        ]
    },
    "messages": [
        {
            "code": "0",
            "message": "OK"
        }
    ]
}

登录后复制

我们的任务是遍历 data 数组中的每一条记录，提取 fieldData.Start_Date 的月份信息，并计算每个月份对应的记录数量。

2. PHP 解析 JSON 数据

在 PHP 中，json_decode() 函数是处理 JSON 数据的核心。它能将 JSON 格式的字符串转换成 PHP 可操作的数据类型，通常是对象或关联数组。为了方便后续的数据访问，我们通常将其解码为关联数组。

<?php

// 假设 $jsonString 变量已包含上述 JSON 数据
$jsonString = '{ ... }'; // 实际应用中会从文件、网络请求等获取

// 使用 json_decode 将 JSON 字符串解码为 PHP 关联数组
// 第二个参数设置为 true，表示解码为关联数组
$decodedData = json_decode($jsonString, true);

// 重要的错误检查：验证 JSON 解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    die("JSON 解码失败: " . json_last_error_msg());
}

// 此时 $decodedData 变量是一个 PHP 关联数组，可以通过键名访问数据
// 例如：$decodedData['response']['data']
?>

登录后复制

解码成功后，您可以像操作普通 PHP 数组一样访问 JSON 数据中的各个部分。

3. 按月份统计数据

统计过程包括初始化计数器、遍历数据、提取日期信息并进行累加。

立即学习“PHP免费学习笔记（深入）”；

3.1 初始化月份计数器

在开始遍历数据之前，我们需要创建一个空的关联数组，用于存储每个月份的统计结果。该数组的键将是月份（例如 "10" 代表十月，"11" 代表十一月），而值将是对应月份的记录总数。

$monthCounts = []; // 用于存储最终按月份统计的结果

登录后复制

3.2 遍历数据并提取月份信息

接下来，我们将遍历 $decodedData['response']['data'] 数组中的每一条记录。对于每条记录，我们将执行以下步骤：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

获取 Start_Date 字符串：从当前记录的 fieldData 字段中提取 Start_Date 的值。
日期字符串转 Unix 时间戳：使用 PHP 内置的 strtotime() 函数将 Start_Date 字符串（例如 "10/03/2021"）转换为 Unix 时间戳。strtotime() 能够智能识别多种日期时间格式。
时间戳转月份：利用 date("m", ...) 函数，从上一步获取的 Unix 时间戳中提取两位数的月份字符串（例如 "10" 或 "11"）。
累加计数：检查 $monthCounts 数组中是否已经存在该月份的键。如果不存在，则将其初始化为 0；然后，将该月份的计数器值加 1。

3.3 完整示例代码

以下是实现上述逻辑的完整 PHP 代码：

<?php

// 模拟从 API 获取的 JSON 字符串
$jsonString = '{
    "response": {
        "dataInfo": {
            "foundCount": 494,
            "returnedCount": 4
        },
        "data": [
            {
                "fieldData": {
                    "Closed_Date": "10/03/2021",
                    "Start_Date": "10/03/2021"
                },
                "portalData": {},
                "recordId": "152962",
                "modId": "3"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/14/2021",
                    "Start_Date": "11/06/2021"
                },
                "portalData": {},
                "recordId": "153228",
                "modId": "22"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/07/2021",
                    "Start_Date": "11/06/2021"
                },
                "portalData": {},
                "recordId": "153329",
                "modId": "7"
            },
            {
                "fieldData": {
                    "Closed_Date": "11/08/2021",
                    "Start_Date": "11/08/2021"
                },
                "portalData": {},
                "recordId": "153513",
                "modId": "3"
            }
        ]
    },
    "messages": [
        {
            "code": "0",
            "message": "OK"
        }
    ]
}';

// 1. 解码 JSON 字符串
$decodedData = json_decode($jsonString, true);

// 重要的错误检查：验证 JSON 解码是否成功以及关键数据结构是否存在
if (json_last_error() !== JSON_ERROR_NONE || !isset($decodedData['response']['data'])) {
    die("JSON 解码失败或数据结构不符合预期: " . json_last_error_msg());
}

// 2. 初始化月份计数器
$monthCounts = [];

// 3. 遍历数据并统计
$items = $decodedData['response']['data'];
foreach ($items as $item) {
    // 确保 'fieldData' 和 'Start_Date' 字段存在，防止因数据缺失导致错误
    if (isset($item['fieldData']['Start_Date'])) {
        $startDateString = $item['fieldData']['Start_Date'];

        // 将日期字符串转换为 Unix 时间戳
        $timestamp = strtotime($startDateString);

        // 检查日期转换是否成功，因为 strtotime() 可能会返回 false
        if ($timestamp !== false) {
            // 从时间戳中提取月份（两位数格式，如 "01", "10", "11"）
            $month = date("m", $timestamp);

            // 如果该月份尚未在 $monthCounts 中，则初始化为 0
            if (!isset($monthCounts[$month])) {
                $monthCounts[$month] = 0;
            }
            // 增加该月份的计数
            $monthCounts[$month]++;
        } else {
            // 记录或处理无法解析的日期字符串
            error_log("警告：无法解析日期字符串: " . $startDateString);
        }
    } else {
        // 记录或处理缺少关键字段的数据项
        error_log("警告：数据项中缺少 'fieldData.Start_Date' 字段");
    }
}

// 4. 输出统计结果
echo "<pre>";
print_r($monthCounts);
echo "</pre>";

?>

登录后复制

4. 结果输出与验证

执行上述 PHP 代码后，您将获得一个关联数组作为输出，其中键是月份，值是该月份对应的记录数量。对于本教程提供的示例 JSON 数据，预期的输出将是：

Array
(
    [10] => 1
    [11] => 3
)

登录后复制

这个结果清晰地表明，在原始数据中，10 月份有一条记录，而 11 月份有三条记录，与我们的统计目标完全一致。

5. 注意事项与总结

日期格式的鲁棒性: strtotime() 函数在处理多种日期格式方面表现出色，但对于非常规或不明确的日期格式，其解析结果可能不准确。如果 Start_Date 的格式变化多端或较为复杂，建议使用 DateTime::createFromFormat() 函数进行更精确和严格的日期解析，以确保数据的准确性。
全面的错误处理: 在生产环境中，健壮性至关重要。务必对 json_decode() 的返回值进行 json_last_error() 检查，对 strtotime() 的返回值进行 false 检查，并对数组键的存在性（例如 isset($item['fieldData']['Start_Date'])）进行验证。这些检查有助于防止因数据异常或缺失而导致的程序崩溃。
性能考量: 对于包含海量记录的 JSON 数据，循环遍历可能会带来一定的性能开销。然而，对于大多数常见规模的数据集，上述方法已经足够高效。如果面临极端大数据量的场景，可以考虑采用更优化的数据处理策略或使用专门的数据处理库。
统计维度的扩展: 本教程展示了按月份统计的方法。如果您需要按年份、季度、周或更复杂的日期范围进行统计，只需调整 date() 函数的格式参数（例如 date("Y", $timestamp) 获取年份，date("W", $timestamp) 获取周数）或在循环中添加额外的逻辑判断即可实现。

通过本教程的学习，您应该已经掌握了使用 PHP 解析 JSON 数据，并根据日期字段进行高效筛选和统计的核心技术。这些技能在处理 API 数据、生成报告和进行数据分析等场景中非常实用。

以上就是PHP 处理 JSON：按日期字段分组统计每月数据的详细内容，更多请关注php中文网其它相关文章！