From 8444ee5a50f4731fb52bda9ba2dfa044c32ac823 Mon Sep 17 00:00:00 2001 From: unknown Date: Thu, 13 Feb 2014 20:00:33 +0800 Subject: [PATCH] =?utf8?q?=E5=88=A0=E9=99=A4README.html?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit --- README.html | 464 ------------------------------------------------------------ 1 file changed, 464 deletions(-) delete mode 100644 README.html diff --git a/README.html b/README.html deleted file mode 100644 index 54392b2..0000000 --- a/README.html +++ /dev/null @@ -1,464 +0,0 @@ - - - -README - - - - -

LunarCalendar

-

农历（阴历）万年历，是一款支持Node.js和浏览器端使用的全功能农历和公历日历类库。支持农历与公历之间相互转换，含有二十四节气，天干地支纪年纪月纪日，生肖属相，公历节假日及农历传统节假日信息等功能。自带2013-2014节假日安排数据，并可自行配置。带有黄历数据，可自行选择配置。支持1891-2100年。使用LunarCalendar可快速开发一款属于自己的万年历产品，行动起来吧！

-

Install

-
    -
  1. Node.js服务器端(使用npm安装)： -npm install lunar-calendar
    2. -
  2. 浏览器端使用，引用脚本： -<script type="text/javascript" src="lib/LunarCalendar.js"></script>
    3. -
-

Usage

-

Node.js

-

var LunarCalendar = require("lunar-calendar");

-

浏览器

-

window.LunarCalendar是一个全局对象，可以全局作用域直接调用。

-

方法列表

-

LunarCalendar.calendar(year,month[,fill])

-

通过公历获取某月农历数据

-

参数说明

- -

返回数据

-
{
-    "firstDay": 5, //该月1号星期几（日历开始位置）
-    "monthDays": 28, //该月天数
-    "monthData": [ //本月所有日历数据
-        {
-            "year": 2014, //公历年
-            "month": 2, //公历月
-            "day": 1, //公历日
-            "zodiac": "蛇", //生肖属相
-            "GanZhiYear": "癸巳", //干支纪年
-            "GanZhiMonth": "乙丑", //干支纪月
-            "GanZhiDay": "癸卯", //干支纪日
-            "worktime": 2, //0无特殊安排，1工作，2放假
-            "lunarYear": 2014, //农历年
-            "lunarMonth": 1, //农历月（1-13，有闰月情况，比如当前闰9月，10表示闰9月，11表示10月）
-            "lunarDay": 2, //农历日
-            "lunarMonthName": "正月", //农历月中文名
-            "lunarDayName": "初二", //农历日中文名
-            "lunarLeapMonth": 9, //农历闰月所在月份，0表示无闰月
-            "solarFestival": "", //公历节假日，undefined或‘劳动节’之类
-            "lunarFestival": "", //农历节假日，undefined或‘除夕’之类
-            "term": "" //二十四节气名，undefined或‘立春’之类
-        },
-        ...
-    ]
-}
-
- -

LunarCalendar.solarCalendar(year,month[,fill])

-

获取公历某月日历数据（不带农历信息）

-

参数说明

- -

返回数据

-
{
-    "firstDay": 5, //该月1号星期几（日历开始位置）
-    "monthDays": 28, //该月天数
-    "monthData": [ //本月所有日历数据
-        {
-            "year": 2014, //公历年
-            "month": 2, //公历月
-            "day": 1 //公历日
-        },
-        ...
-    ]
-}
-
- -

LunarCalendar.solarToLunar(year,month,day)

-

将公历转换为农历

-

参数说明

- -

返回数据

-
{
-    "zodiac": "蛇", //生肖属相
-    "GanZhiYear": "癸巳", //干支纪年
-    "GanZhiMonth": "乙丑", //干支纪月
-    "GanZhiDay": "癸卯", //干支纪日
-    "worktime": 2, //0无特殊安排，1工作，2放假
-    "lunarYear": 2014, //农历年
-    "lunarMonth": 1, //农历月（1-13，有闰月情况，比如当前闰9月，10表示闰9月，11表示10月）
-    "lunarDay": 2, //农历日
-    "lunarMonthName": "正月", //农历月中文名
-    "lunarDayName": "初二", //农历日中文名
-    "lunarLeapMonth": 9, //农历闰月所在月份，0表示无闰月
-    "solarFestival": "", //公历节假日，undefined或‘劳动节’之类
-    "lunarFestival": "", //农历节假日，undefined或‘除夕’之类
-    "term": "" //二十四节气名，undefined或‘立春’之类
-}
-
- -

LunarCalendar.lunarToSolar(year,month,day)

-

将农历转换为公历

-

参数说明

- -

返回数据

-
{
-    "year": 2014, //公历年
-    "month": 1, //公历月
-    "day": 31 //公历日
-}
-
- -

LunarCalendar.setWorktime(data)

-

设置某年的节假日安排信息（类库已内置2013-2014年的数据）

-

参数说明

- -

参数data格式如下：

-
{
-    "y2014": {
-        "d0101": 2,
-        "d0126": 1,
-        "d0131": 2,
-        "d0201": 2,
-        "d0202": 2,
-        "d0203": 2,
-        "d0204": 2,
-        "d0205": 2,
-        "d0206": 2,
-        "d0208": 1,
-        "d0405": 2,
-        "d0407": 2,
-        "d0501": 2,
-        "d0502": 2,
-        "d0503": 2,
-        "d0504": 1,
-        "d0602": 2,
-        "d0908": 2,
-        "d0928": 1,
-        "d1001": 2,
-        "d1002": 2,
-        "d1003": 2,
-        "d1004": 2,
-        "d1005": 2,
-        "d1006": 2,
-        "d1007": 2,
-        "d1011": 1
-    }
-}
-
- -

黄历数据

-

在目录/hl/下有2008-2020年的黄历数据，用户可自行选择在自己万年历中进行添加。

-

其它

- -

JasonZhou

- - - - -- 2.7.4