lunarFun

原生农历(阴历, 阴阳历)和公历(阳历)互相转换的插件

如何使用

直接下载引入

把项目文件夹下的 lunarFun.js 或压缩后的 lunarFun.min.js 下载到本地并引入。

<script src="你存放的文件夹/lunarFun.min.js"></script>
<script>
    lunarFun.gregorianToLunal(1906, 1, 26); // [1906, 1, 2, false]
    lunarFun.lunalToGregorian(1906, 4, 30, true); // [1906, 6, 21]
</script>

使用 npm 引入

项目支持 npm 进入，打开终端运行下方的命令

npm i lunar-fun -save

然后在项目入口文件引入

let lunarFun = require('lunar-fun');

方法列表

主要方法

具体方法参数说明可查看 lunarFun.js 文件内各方法介绍

方法名	参数	返回值	版本
gregorianToLunal()	lunarFun.gregorianToLunal(2000, 2, 4)	[1999, 12, 29, false]	1.0.0
lunalToGregorian()	lunarFun.lunalToGregorian(1906, 4, 30, true)	[1906, 6, 21]	1.0.0
formatDate()	lunarFun.formatDate(new Date(2019,3,4,5,6,7), 'YYYY-M-D h:mm:s')	"2019-4-4 5:06:7"	1.0.0
formatLunarDate()	lunarFun.formatLunarDate(1906, 4, 22, true)	"一九零六年闰四月廿二日"	1.0.0
toJSON()	lunarFun.toJSON(2000, '16c960')	{"year": 2000,"isRun": false,"runMonth": 0,"runMonthDays": 0,"monthsDays": [30, 30, 29, 29, 30, 29, 29, 30, 29, 30, 30, 29],"firstMonth": 2,"firstDay": 5}	1.0.0
isLeapYear()	lunarFun.isLeapYear(2000)	true	1.0.0
getHeavenlyStems()	lunarFun.getHeavenlyStems(1999)	"己"	1.0.0
getEarthlyBranches()	lunarFun.getEarthlyBranches(1999)	"卯"	1.0.0
getZodiac()	lunarFun.getZodiac(1999)	"兔"	1.0.0
getMonthNumberDays()	lunarFun.getMonthNumberDays(1999, 6)	30	1.0.0
getLunarMonthNumberDays()	lunarFun.getLunarMonthNumberDays(1906, 4, true)	30	1.0.0
getLunarYearDaysTotal()	lunarFun.getLunarYearDaysTotal(1906)	384	1.0.0
distanceLunarFirstDays()	lunarFun.distanceLunarFirstDays(1906, 4, 1, true)	118	1.0.0
distanceDate()	lunarFun.distanceDate(new Date(1999, 6, 6), new Date(1997, 5, 13))	754	1.0.0
getDateYMD()	lunarFun.getDateYMD(2019,3,4).toString()	"Mon Mar 04 2019 00:00:00 GMT+0800 (**标准时间)"	1.0.0

方法明细

formatDate(dateObj, formatText) 方法明细

dateObj 时间对象如果不传则默认当前时间
formatText 时间格式区分大小写如果不传则默认格式为 YYYY-MM-DD hh:mm:ss

formatText 的字符含义

格式	含义	备注	举例
YYYY	年	-	1999
M	月	不补零	6
MM	月	补零	06
D	日	不补零	6
DD	日	补零	06
h	小时	不补零	7
hh	小时	补零	07
m	分钟	不补零	8
mm	分钟	补零	08
s	秒	不补零	9
ss	秒	补零	09
W	星期	不补零	1
WW	星期	补零	01
WT	星期	文字表述	星期一
timestamp	JS时间戳	13位毫秒级	0928624089000

更新日志

20191116

发布

发布 v1.0.0 版本

农历数据说明

农历和公历不一样，农历年份信息和公历不一样，没有规律可遵循，都是由天文台观测计算。大部分公历换农历都是用查表法进行转换。

数据来源

香港天文台获取农历 1901年 - 2099年数据
asia-home 获取农历 2100年数据 (这网站打开贼慢)

数据误差

由于计算数十年后的月相及节气时间可能会有数分钟的误差，若新月(即农历初一)或节气时间很接近午夜零时，相关农历月份或节气的日期可能会有一日之差别。
这些情况会出现在（以下年份都是公历表示）

2057年09月28日、2089年09月04日、2097年08月07日的新月
2021年的冬至(2021年12月21日)、2051年的春分(2051年03月20日)、2083年的立春(2083年02月03日)、2084年的春分(2084年03月19日)

一些常识

有闰月的年份中，农历节日只按原月算，不按闰月算，只有除夕例外，有闰腊月则过闰腊月除夕。（除夕是一年的最后一天的夜晚）
在一个公历里面不可能出现两个农历新年，农历春节(正月初一)在一月和二月之间，具体区间可自行查询。

年份表示

农历年份对应的不应该是数字形式，而是以立春为界限的干支表示法（例如：辛丑年、壬寅年等）
这里为了代码理解方便，把农历年份的正月初一所在的公历年份作为农历年份的数字表示
例如：公历1902年2月8日是壬寅年正月初一，所以壬寅年对应的数字是1902

数据压缩

一开始是从网上获取各种十六进制的农历年份数据信息，但都不准确，无奈自己从香港天文台把自己想要的数据扒下来，初始数据格式如下：

let lunarInfo = {
    // JSON 的 key 推荐是双引号括起来的字符串，虽然在 JS 中还可以用数字作为 key
    "1901": {
        "year": 1901, // 农历年份的数字表示
        "firstMonth": 2, // 农历年份正月初一对应的公历月份
        "firstDay": 19, // 农历年份正月初一对应的公历日子
        "isRun": false, // 是否是闰年
        "runMonth": 0, // 是闰年的话闰几月，非闰年为 0
        "runMonthDays": 0, // 是闰年的话闰月的天数，非闰年为 0
        "monthsDays": [29,30,29,29,30,29,30,29,30,30,30,29] // 正常十二个月的每月天数
    },
    // other coding...
}

200 个数据扒下来文件非常大，达到 30kb 多，压缩后大概 2kb。
原始文件在 lunarData/lunarInfoFormat.js, 压缩后的文件在 lunarData/lunarInfo.js
网上大多是用二进制表示然后压缩成十六进制，这里我也沿用，但各个位置上表示的数据确有差别。具体过程如下：
用 24 位二进制数表示数据信息（二进制位数从右往左数）

24	23-19	18-17	16-13	12-9	8-5	4-1
表示闰月大小	正月初一对应的日子	正月初一对应的月份	正常月份	正常月份	正常月份	表示闰月

1-4 位
- 表示是否有闰月，如果没有，则 1-4 都为 0, 如果有闰月则用二进制表示闰几月，不足四位左边补零到四位。
5-16 位
- 表示农历正常月份(除闰月) 1-12 月的天数，1表示大月30天，0表示小月29天。16位-5位分别表示1月-12月。
17-18 位
- 二进制表示农历正月初一对应的公历月份，不足两位左边补零到两位，正月初一春节只会出现在公历的一月和二月，所以用两位二进制数就能表示完全
19-23 位
- 二进制表示农历正月初一对应的公历日子，不足五位补零到五位。注意：这里表示日子是用了5位二进制数，因为从16开始(二进制表示10000)，用二进制表示就需要用5位数了，而公历月份天数最大可以有 31 天。
24 位
- 第二十六位表示闰月的天数。1表示大月30天，0表示小月29天。仅在是闰年的情况下生效

这样就得到了一串 24 位的二进制串，然后再转为 16进制数即可。
注意：从16进制数转为2进制数的时候如果不足24位，则需要在左边补零到24位，再根据上面的规则转为相应的数据。

例子：农历 1901 年的数据转为 16 进制数
1901年不是闰年，所以 4-1 是 0000
根据 1901 年的正常月份可知 16-5 位是 010010101110
1901 年正月初一对应的公历月份是 2 所以 18-17 位是 10
1901 年正月初一对应的公历日子是 19 所以 23-19 位是 10011
1901年不是闰年，所以第 24 位我们填 0
最后得到的二进制串是 010011100100101011100000
转为十六进制后是 0x4e4ae0

例子：农历 1906 年的数据转为 16 进制数
1906年是闰年，且闰4月，所以 4-1 是 0100
根据 1906 年的正常月份可知 16-5 位是 011001010101
1906 年正月初一对应的公历月份是 1 所以 18-17 位是 01
1906 年正月初一对应的公历日子是 25 所以 23-19 位是 11001
1906年是闰年，且闰月是大月，所以第 24 位我们填 1
最后得到的二进制串是 111001010110010101010100
转为十六进制后是 0xe56554

附上根据十六进制字符串转为JSON格式数据的方法

/**
* 用 2000 年数据 16c960 来做 demo
* 传入年份和其对应的十六进制字符串，返回JS对象表示的数据
* 传入的十六进制字符串不包括 “0x” 前缀
*/
function toJSON(year, numStr) {
    if (!year || !numStr) {
        return '';
    }
    let hexadecimal = numStr.toString('16'); // 保证使用的数据是十六进制的字符串
    let binary = parseInt(hexadecimal, 16).toString(2);
    if (binary.length !== 24) { // 不足24位则左边补0补足24位
        binary = '0'.repeat(24 - binary.length) + binary;
    }
    let lunarItem = {
        'year': +year,
    };
    // binary 第 21-24 个字符判断是否是闰年，如果是则得到闰几月
    // binary 第 1 个字符是当年份是闰年的时候判断闰月的天数，1是大月30天， 0是小月29天，如果不是闰年则为0
    let runInfo = binary.slice(-4);
    if (runInfo === '0000') {
      lunarItem.isRun = false;
      lunarItem.runMonth = 0;
      lunarItem.runMonthDays = 0;
    } else {
      lunarItem.isRun = true;
      lunarItem.runMonth = parseInt(runInfo, 2);
      lunarItem.runMonthDays = +binary.slice(0, 1) + 29;
    }

    // binary 第 9-20 个字符是当年的正常月份天数，1是大月30天， 0是小月29天
    lunarItem.monthsDays = [];
    let monthInfo = binary.slice(8, 20);
    [...monthInfo].map(item => {
        lunarItem.monthsDays.push(+item + 29);
    })

    // binary 第 7-8 个字符是 农历年份正月初一对应的公历月份
    lunarItem.firstMonth = parseInt(binary.slice(6, 8), 2);

    // binary 2-6 个字符是 农历年份正月初一对应的公历日子
    lunarItem.firstDay = parseInt(binary.slice(1, 6), 2);

    return lunarItem;
}
console.log(toJSON(2000, '16c960'));
/*
    {
         "year": 2000,
         "isRun": false,
         "runMonth": 0,
         "runMonthDays": 0,
         "monthsDays": [30, 30, 29, 29, 30, 29, 29, 30, 29, 30, 30, 29],
         "firstMonth": 2,
         "firstDay": 5
    }
*/

附上根据JSON格式数据转为十六进制字符串的方法

/**
 * 以下是把 lunarInfoFormat 数据转为 16进制字符串方法
 * 传入 lunarInfoFormat 数据，返回十六进制字符串组成的数组
 */
function toHexadecimalStr(data) {
    let HexadecimalStrArr = [];
    let yearArr = Object.keys(data);
    yearArr.sort(function (a, b) {
        return a-b;
    })
    yearArr.forEach(item => {
        let binaryStrArr = [];

        // 1-4
        let oneToFour = [];
        if (data[item].isRun) { // 如果是闰年
            let isRun2 = data[item].runMonth.toString(2);
            isRun2 = '0000' + isRun2;
            oneToFour = [...isRun2].slice(-4);
        } else { // 如果不是闰年
            oneToFour = ['0', '0', '0', '0'];
        }

        // 16-5
        let sixteenToFive = [];
        data[item].monthsDays.forEach((item, index) => {
            sixteenToFive.push((item - 29) + '');
        })

        // 18-17
        let eighteenToSeventeen = [];
        let firstMonth2 = data[item].firstMonth.toString(2);
        firstMonth2 = '00' + firstMonth2;
        eighteenToSeventeen = [...firstMonth2].slice(-2);

        // 19-23
        let nineteenToTwentyThree = [];
        let firstDay2 = data[item].firstDay.toString(2);
        firstDay2 = '00000' + firstDay2;
        nineteenToTwentyThree = [...firstDay2].slice(-5);

        // 24
        let twentyFour = ['0'];
        if (data[item].isRun && (data[item].runMonthDays === 30)) {
            twentyFour = ['1'];
        }

        binaryStrArr = [...twentyFour, ...nineteenToTwentyThree, ...eighteenToSeventeen, ...sixteenToFive, ...oneToFour];
        HexadecimalStrArr.push((parseInt(binaryStrArr.join(''), 2)).toString(16))
    })
    
    return HexadecimalStrArr;
}

xmm228 / lunarfun Goto Github PK

lunarfun's Introduction