Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv1.7.8

lunar

a calendar library for Solar and Chinese Lunar

AndroidiOSWebmacOSWindowsLinux
pub.dev API documentation Source code
30-day downloads
8.8K
Likes
54
Pub points
110

Install package

flutter pub add lunar

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

Lunar is a Flutter/Dart package that provides comprehensive calendar functionality for both Solar and Chinese Lunar calendars. It enables developers to convert dates between the two systems, retrieve lunar date details such as zodiac signs, lunar months, and solar terms, and display culturally relevant calendar information. Ideal for apps requiring traditional Chinese calendar integration, it supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • Date conversion between Solar and Lunar calendars
  • Displaying Chinese lunar zodiac and month information
  • Supporting traditional festival and solar term tracking
  • Building cultural or astrology-related applications
  • Integrating lunar-based scheduling features

Key features

  • Bidirectional date conversion (Solar ↔ Lunar)
  • Support for Chinese zodiac and lunar month data
  • Inclusion of solar terms and festival dates
  • Cross-platform compatibility
  • Simple and intuitive API design

Suitable for

  • Apps targeting Chinese-speaking audiences
  • Cultural or heritage-focused applications
  • Astrology and fortune-telling tools
  • Calendar and reminder apps with lunar support

Considerations

  • Requires understanding of Chinese lunar calendar conventions
  • Limited documentation beyond basic usage
  • May need additional localization for non-Chinese users

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

lunar License

lunar是一款无第三方依赖的日历工具，支持公历(阳历)、农历(阴历、老黄历)、道历、佛历，支持星座、儒略日、干支、生肖、节气、节日、彭祖百忌、吉神(喜神/福神/财神/阳贵神/阴贵神)方位、胎神方位、冲煞、纳音、星宿、八字、五行、十神、建除十二值星、青龙名堂等十二神、黄道日及吉凶、法定节假日及调休等。

自v1.2.22起，最低要求flutter 2.0.0、dart 2.12.0。

示例

dependencies:
  lunar: ^1.7.7
 
import 'package:lunar/lunar.dart';
 
void main() {
  //今天
  //Lunar date = Lunar.fromDate(DateTime.now());
           
  //指定阴历的某一天
  Lunar date = Lunar.fromYmd(1986, 4, 21);
  print(date.toFullString());
  print(date.getSolar().toFullString());
}

输出结果：

一九八六年四月廿一 丙寅(虎)年 癸巳(蛇)月 癸酉(鸡)日 子(鼠)时 纳音[炉中火 长流水 剑锋金 桑柘木] 星期四 北方玄武 星宿[斗木獬](吉) 彭祖百忌[癸不词讼理弱敌强 酉不会客醉坐颠狂] 喜神方位[巽](东南) 阳贵神方位[巽](东南) 阴贵神方位[震](正东) 福神方位[兑](正西) 财神方位[离](正南) 冲[(丁卯)兔] 煞[东]
1986-05-29 00:00:00 星期四 双子座

文档

请移步至 https://6tail.cn/calendar/api.html

Star History

Star History Chart

Categories

Calendar

Source repository

Projects using this package