志愿时长计算器

一个简单实用的工具，用于统计指定日期范围内的志愿服务时长。支持图形化界面，可打包为免安装的 exe 程序。

功能特点

• 图形化界面，操作简单直观
• 自定义统计日期范围（开始日期 ~ 结束日期）
• 支持多行数据粘贴输入
• 自动计算总服务时长
• 支持小时和分钟的自动进位计算
• 纯本地运行，保护志愿者隐私

使用方法

方式一：直接运行 exe 程序

1. 双击运行 志愿时长计算器.exe
2. 输入开始日期和结束日期（格式：YYYY-MM-DD）
3. 将志愿记录数据粘贴到输入框中
4. 点击"查询"按钮查看统计结果

方式二：运行 Python 源码

python volunteer_calculator_gui.py

数据格式要求

输入数据支持以下两种 JSON 格式：

格式一：完整 JSON 对象

{
    "records": [
        {
            "startDateStr": "2024-01-01",
            "serviceMinuteStr": "2小时30分钟"
        },
        {
            "startDateStr": "2024-02-01",
            "serviceMinuteStr": "1小时45分钟"
        }
    ]
}

格式二：直接粘贴数组

[
    {
        "startDateStr": "2024-01-01",
        "serviceMinuteStr": "2小时30分钟"
    },
    {
        "startDateStr": "2024-02-01",
        "serviceMinuteStr": "1小时45分钟"
    }
]

数据字段说明

字段	说明
startDateStr	志愿服务开始日期，格式为 YYYY-MM-DD
serviceMinuteStr	服务时长，格式为 X小时Y分钟

打包为 exe 文件

如需重新打包，运行以下命令：

pip install pyinstaller
pyinstaller --onefile --windowed --name "志愿时长计算器" --clean volunteer_calculator_gui.py

或直接运行 build.bat 脚本。

打包完成后，exe 文件位于 dist 文件夹中。

文件说明

├── volunteer_calculator_gui.py  # GUI 版本主程序
├── fetch_volunteer_hours.py    # 命令行版本（原始版本）
├── build.bat                    # 打包脚本
├── dist/
│   └── 志愿时长计算器.exe        # 打包后的可执行文件
└── README.md

运行环境要求

运行源码：

• Python 3.x
• tkinter（Python 内置，无需额外安装）

运行 exe：

• Windows 操作系统
• 无需安装 Python 环境

隐私保护

本工具使用者需保护志愿者个人信息安全：

• 所有数据处理均在本地完成
• 不涉及爬虫和数据上传功能
• 通过手动复制粘贴输入数据，避免自动抓取