# LunarCalendar

**Repository Path**: kl222/LunarCalendar

## Basic Information

- **Project Name**: LunarCalendar
- **Description**: 用QT写的带农历的日历。Use Qt write lunar calendar。此库仅为GITHUB库的镜像。
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://github.com/KangLin/LunarCalendar
- **GVP Project**: No

## Statistics

- **Stars**: 42
- **Forks**: 23
- **Created**: 2019-06-04
- **Last Updated**: 2025-11-06

## Categories & Tags

**Categories**: application-software

**Tags**: None

## README

## 农历日历

作者：康 林 <kl222@126.com>

------------------------------------------------

[:us: English](README.md)

- 项目位置: 
  - 主库: https://github.com/KangLin/LunarCalendar
  - 镜像库：
    - https://gitee.com/kl222/LunarCalendar
    - https://gitlab.com/kl222/LunarCalendar
    - https://sourceforge.net/projects/lunarcalendar/
    - https://launchpad.net/lunarcalendar
    - https://bitbucket.org/kl222/lunarcalendar
- [项目主页](https://kanglin.github.io/LunarCalendar/html/index.html)

------------------------------------------------

- [![Documentation](https://img.shields.io/badge/documentation-online-blue)](https://kanglin.github.io/LunarCalendar/html/index.html)

- 主分支

[![build](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml)
[![Windows 编译状态](https://ci.appveyor.com/api/projects/status/p5vhmmbuql9fyfpl/branch/master?svg=true)](https://ci.appveyor.com/project/KangLin/lunarcalendar/branch/master)

- 开发分支

[![build](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml/badge.svg?branch=develop)](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml)
[![Windows 编译状态](https://ci.appveyor.com/api/projects/status/p5vhmmbuql9fyfpl/branch/develop?svg=true)](https://ci.appveyor.com/project/KangLin/lunarcalendar/branch/develop)

[![GitHub 点赞数](https://img.shields.io/github/stars/KangLin/LunarCalendar)](https://star-history.com/#KangLin/LunarCalendar&Date)
[![Gitee 点赞数](https://gitee.com/kl222/LunarCalendar/badge/star.svg?theme=dark)](https://gitee.com/kl222/LunarCalendar/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/KangLin/LunarCalendar)](https://github.com/KangLin/LunarCalendar/forks)
[![GitHub issues](https://img.shields.io/github/issues/KangLin/LunarCalendar)](https://github.com/KangLin/LunarCalendar/issues)
[![Current release](https://img.shields.io/github/release/KangLin/LunarCalendar)](https://github.com/KangLin/LunarCalendar/releases)
[![All releases downloads](https://img.shields.io/github/downloads/KangLin/LunarCalendar/total?label=Github%20下载量)](https://github.com/KangLin/LunarCalendar/releases)
[![Download LunarCalendar](https://img.shields.io/sourceforge/dt/lunarcalendar.svg?label=Sourceforge%20下载量)](https://sourceforge.net/projects/lunarcalendar/files/latest/download)

------------------------------------------------

### 目录：

- [功能](#功能)
- [下载安装包](#下载安装包)
- [捐赠](#捐赠)
- [屏幕截图](#屏幕截图)
- [编译](#编译)
- [其它应用使用本项目](#其它应用使用本项目)
- [贡献](#贡献)
- [许可协议](#许可协议)
    + [第三方库](#第三方库)

------------------------------------------------

### 功能

Qt 写的农历。它提供：

- 一个Qt界面的农历日历库，支持 QSS (换肤功能）。
  + 阳历
  + 农历
  + 阳历和农历节日（例如：中国节假日(一群闲得蛋疼的人搞出来的玩意)，节气）
  + 阳历和农历周年纪念日（例如：生日，结婚纪念日等）
  + 在日历上显示用户自定义任务提示（用高亮圆点显示）
  + 工具提示(ToolTip)显示详细的提示内容
  + 月视图
  + 周视图
- 示例
  + 一个简单的日历应用程序。用于示例如何使用此农历日历库。
  + 此库的一个完整应用 [日历](https://github.com/KangLin/Calendar)
- 跨平台，支持多操作系统。
  详见：[Qt5 支持平台](https://doc.qt.io/qt-5/supported-platforms.html)、[Qt6 支持平台](https://doc.qt.io/qt-6/supported-platforms.html)。
  + [x] Windows
  + [x] Linux、Unix
  + [x] Android
  + [x] Mac os
  + [ ] IOS

Mac os 和 IOS ，本人没有相应设备，请有相应设备的同学自己编译，测试。

### 捐赠

[![捐赠](https://gitee.com/kl222/RabbitCommon/raw/master/Src/Resource/image/Contribute.png "捐赠")](https://gitee.com/kl222/RabbitCommon/raw/master/Src/Resource/image/Contribute.png "捐赠")

### 屏幕截图
- Windows

![屏幕截图](Docs/image/ScreenShot.png "屏幕截图")
![屏幕截图](Docs/image/ScreenShotQss.png "屏幕截图")

- Ubuntu

![Ubuntu 屏幕截图](Docs/image/ScreenShotUbunt.png "Ubuntu 屏幕截图")

- Android

![Android 屏幕截图](Docs/image/ScreenShotAndroid.png "Android 屏幕截图")

- 任务

![任务](Docs/image/Task.png "任务")

### 下载安装包

[下载安装包](https://github.com/KangLin/LunarCalendar/releases/latest)

- 开发包： *.zip
- 示例程序安装包：
  - Ubuntu: *.deb
  - Windows: *.exe
  - Android: *.apk
- 文档：[LunarCalendar_v1.0.4_document.zip](https://github.com/KangLin/LunarCalendar/releases/download/v1.0.4/LunarCalendar_v1.0.4_document.zip)

### 文档

- [在线文档](https://kanglin.github.io/LunarCalendar/html/index.html)

- [使用文档](Docs/User.md)
- [开发文档](Docs/Developer.md)

### 贡献

- [问题](https://github.com/KangLin/LunarCalendar/issues)
- [项目位置](https://github.com/KangLin/LunarCalendar)
- [贡献者](https://github.com/KangLin/LunarCalendar/graphs/contributors)

### 许可协议

[许可协议](License.md "License.md")

请遵守本协议和下列第三方库的许可协议，并感谢第三方库的作者。

#### 第三方库

- [寿星天文历](https://github.com/yuangu/sxtwl_cpp) 

#### 使用本项目的项目

- [日历](https://github.com/KangLin/Calendar)