3 农历(阴历)万年历,是一款支持Node.js和浏览器端使用的全功能农历和公历日历类库。支持农历与公历之间相互转换,含有二十四节气,天干地支纪年纪月纪日,生肖属相,公历节假日及农历传统节假日信息等功能。自带2013-2014节假日安排数据,并可自行配置。带有黄历数据,可自行选择配置。支持1891-2100年。使用**LunarCalendar**可快速开发一款属于自己的万年历产品,行动起来吧!
7 1. Node.js服务器端(使用npm安装):
8 `npm install lunar-calendar`
10 `<script type="text/javascript" src="lib/LunarCalendar.min.js"></script>`
15 var LunarCalendar = require("lunar-calendar");
18 `window.LunarCalendar`是一个全局对象,可以全局作用域直接调用。
23 ![二维码](http://cdn.tuijs.com/upload/1956115939.png)
25 ![小推万年历截图](http://cdn.tuijs.com/upload/calendar_photo.png)
28 ###LunarCalendar.calendar(year,month[,fill])###
32 - @param {Number} `year` 公历年 范围[1891-2100]
33 - @param {Number} `month` 公历月 范围[1-12]
34 - @param {Boolean} `fill`(可选) 是否填充当月日历首尾日期,设为true时,会在首尾填入上下月数据,自动补全一个7*6阵列数据。(可更美观的打造你的万年历产品)
38 "firstDay": 5, //该月1号星期几(日历开始位置)
39 "monthDays": 28, //该月天数
40 "monthData": [ //本月所有日历数据
46 "GanZhiYear": "癸巳", //干支纪年
47 "GanZhiMonth": "乙丑", //干支纪月
48 "GanZhiDay": "癸卯", //干支纪日
49 "worktime": 2, //0无特殊安排,1工作,2放假
50 "lunarYear": 2014, //农历年
51 "lunarMonth": 1, //农历月(1-13,有闰月情况,比如当前闰9月,10表示闰9月,11表示10月)
53 "lunarMonthName": "正月", //农历月中文名
54 "lunarDayName": "初二", //农历日中文名
55 "lunarLeapMonth": 9, //农历闰月所在月份,0表示无闰月
56 "solarFestival": "", //公历节假日,undefined或‘劳动节’之类
57 "lunarFestival": "", //农历节假日,undefined或‘除夕’之类
58 "term": "" //二十四节气名,undefined或‘立春’之类
64 ###LunarCalendar.solarCalendar(year,month[,fill])###
68 - @param {Number} `year` 公历年 范围[1-~]公元后
69 - @param {Number} `month` 公历月 范围[1-12]
70 - @param {Boolean} `fill`(可选) 是否填充当月日历首尾日期,设为true时,会在首尾填入上下月数据,自动补全一个7*6阵列数据。(可更美观的打造你的万年历产品)
74 "firstDay": 5, //该月1号星期几(日历开始位置)
75 "monthDays": 28, //该月天数
76 "monthData": [ //本月所有日历数据
86 ###LunarCalendar.solarToLunar(year,month,day)###
90 - @param {Number} `year` 公历年 范围[1891-2100]
91 - @param {Number} `month` 公历月 范围[1-12]
92 - @param {Number} `day` 公历日 范围[1-31]
97 "GanZhiYear": "癸巳", //干支纪年
98 "GanZhiMonth": "乙丑", //干支纪月
99 "GanZhiDay": "癸卯", //干支纪日
100 "worktime": 2, //0无特殊安排,1工作,2放假
101 "lunarYear": 2014, //农历年
102 "lunarMonth": 1, //农历月(1-13,有闰月情况,比如当前闰9月,10表示闰9月,11表示10月)
104 "lunarMonthName": "正月", //农历月中文名
105 "lunarDayName": "初二", //农历日中文名
106 "lunarLeapMonth": 9, //农历闰月所在月份,0表示无闰月
107 "solarFestival": "", //公历节假日,undefined或‘劳动节’之类
108 "lunarFestival": "", //农历节假日,undefined或‘除夕’之类
109 "term": "" //二十四节气名,undefined或‘立春’之类
112 ###LunarCalendar.lunarToSolar(year,month,day)###
116 - @param {Number} `year` 农历年 范围[1891-2100]
117 - @param {Number} `month` 农历月 范围[1-13](有闰月情况,比如当前闰9月,10表示闰9月,11表示10月)
118 - @param {Number} `day` 农历日 范围[1-30]
127 ###LunarCalendar.setWorktime(data)###
128 设置某年的节假日安排信息(类库已内置2013-2014年的数据)
131 - @param {Object} `data` 节假日安排信息(以年为key,可设置多年)
169 在目录/hl/下有2008-2020年的黄历数据,用户可自行选择在自己万年历中进行添加。
172 用Node.js搭载lunar-calendar类库。
174 - API:http://api.tuijs.com/
177 - JSONP:支持,添加参数callback(仅支持数字,字母,下划线)
181 - 通过公历获取某月农历数据 http://api.tuijs.com/calendar
182 - 获取公历某月日历数据(不带农历信息)http://api.tuijs.com/solarCalendar
183 - 将公历转换为农历http://api.tuijs.com/solarToLunar
184 - 将农历转换为公历http://api.tuijs.com/lunarToSolar
188 http://api.tuijs.com/lunarToSolar?year=2011&month=1&day=1&callback=fn
191 `fn({"year":2011,"month":2,"day":16})`
194 - 项目主页:[http://www.tuijs.com/](http://www.tuijs.com/ "项目主页")
195 - 作者博客:[http://www.2fz1.com/](http://www.2fz1.com/ "作者博客")