tools/reference-repos/github/lunar-python-master/README_EN.md

# lunar [![License](https://img.shields.io/badge/license-MIT-4EB1BA.svg?style=flat-square)](https://github.com/6tail/lunar-python/blob/master/LICENSE)

lunar is a calendar library for Solar and Chinese Lunar.

> Python2 not supported since v1.2.23.

[简体中文](https://github.com/6tail/lunar-python/blob/master/README.md)

## Example

    $ pip install lunar_python
     
    from lunar_python import Lunar
     
    # init lunar by ymd
    lunar = Lunar.fromYmd(1986, 4, 21)
     
    # print lunar
    print(lunar.toFullString())
     
    # convert to solar and print
    print(lunar.getSolar().toFullString())

Output:

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

## Documentation

Please visit [https://6tail.cn/calendar/api.html](https://6tail.cn/calendar/api.html "https://6tail.cn/calendar/api.html")

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=6tail/lunar-python&type=Date)](https://star-history.com/#6tail/lunar-python&Date)