# spring-boot-holiday-starter
**Repository Path**: bzvs_team/spring-boot-holiday-starter
## Basic Information
- **Project Name**: spring-boot-holiday-starter
- **Description**: spring-boot-holiday-starter：一个轻量级节假日判断的小工具！日期判断 工作日，补班日，节假日，周末
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://github.com/bzvs1992/spring-boot-holiday-starter
- **GVP Project**: No
## Statistics
- **Stars**: 29
- **Forks**: 9
- **Created**: 2023-12-06
- **Last Updated**: 2025-05-09
## Categories & Tags
**Categories**: Uncategorized
**Tags**: SpringBoot, Java
## README
Spring-boot-holiday-starter v1.0.0
一个轻量级节假日判断的小工具！
---
## 前言
- 由于项目原因，服务器无网络访问权限，在一些场景下需要判断是否是节假日，所以写了一个工具类，方便使用。
- 开源不易，点个 star 鼓励一下吧！
## 介绍
**Spring-boot-holiday-starter** 一个轻量级节假日判断的小工具，主要解决：获取节假日数据 和 判断是否是节假日。
- 支持说明
- spirngboot 2.7 +
- jdk17 +
## 使用
- yml 配置
```yaml
holiday:
## 节假日数据源方式获取配置：network 在线模式，通过百度日历接口获取； local 本地模式，通过本地JSON文件获取
type: network
## 在线模式配置下，通过设置 years 来进行初始化缓存的日历数据
years:
- 2020
- 2021
## 节假日数据源地址，优先获取系统路径，不存在情况下，再使用 resources 路径
path: /config/holiday.json
```
- HolidayService 接口（用于 获取日历数据 及 节假日/工作日/补班/周末 判断）
- getDate 方法： 获取日历数据
- isHoliday 方法： 是否是节假日
- isWorkDay 方法： 是否是工作日或补班
- isWeekend 方法： 是否是周末
- HolidayFixService 接口 （用于修复日历数据及本地模式下更新JSON文件）
- reset 方法： 数据重置并刷新
- fix 方法：修复缓存数据
- updateFile 方法： 更新JSON文件数据
注：JSON文件可通过 GenerateHolidayTest 进行生成, 示例可参考 HolidayTest
## 计划
### springboot
- [ ] 自动解析官方《节假日安排的通知》，提供多种在线解析方式
- [ ] 支持redis
- [ ] 支持mysql
- [ ] 支持minio
- [ ] 支持mongodb
### solon
- [ ] 支持solon