# PublicHoliday

**Repository Path**: holate/public-holiday

## Basic Information

- **Project Name**: PublicHoliday
- **Description**: 中国节假日静态json文件，获取法定节假日
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 34
- **Forks**: 8
- **Created**: 2020-09-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: utils

**Tags**: None

## README

# 获取并判断节假日

通过将节假日 JSON 文件存放在 Gitee 的公开仓库，实现节假日数据的获取与判断。

数据来源：[timor.tech](http://timor.tech/)  
该项目提供免费的节假日数据接口，更加稳定可靠。

## 为什么使用 Gitee？

1. **定制化**：可自定义某一天为加班日或调休日。
2. **备用方案**：当外部接口不可用时，可作为备用方案使用。  
   **思路**：在 Java 等后端语言中，将多个数据源放入列表，依次调用，直到成功获取数据。

## 目录结构

- `holidays/year/`：包含从 2013 到 2026 年的节假日数据 JSON 文件。
- `pom.xml`：Maven 项目配置文件（如需构建 Java 项目）。
- `README.md`：项目说明文档。

## 使用方法

1. 克隆仓库到本地：
   ```bash
   git clone https://gitee.com/holate/public-holiday.git
   ```
2. 根据需要读取对应年份的 JSON 文件，例如 `2023.json`。
3. 在代码中集成节假日判断逻辑，可结合多个节假日数据源，实现高可用性。

## 贡献

欢迎提交 PR 修改或补充节假日数据。如有自定义节假日需求，可提交 issue 或 PR 进行更新。

## 许可证

本项目遵循 MIT 许可证。详情请查看 `LICENSE` 文件。