加拿大华人论坛 加拿大生活信息ZT JavaScript版本 中国日历类

在加拿大

****************************************************** ** 中国日历类（Chinese Calendar Class (CCC)） ** ** 作者： neweroica ** ** ** 献给为自由代码而孜孜不倦工作的人们 ** ** ** -- Simple is beauty ** ** 2003年5月8日 ** ****************************************************** 一、关于中国日历类及版权申明 1.版权申明 ######################################################################### 版权申明 _______________________________________________________________________ 中国日历类（Chinese Calendar Class (CCC)） 版本：v0.1，JavaScript版本 版权所有 (C) 2002-2003 neweroica ([email protected]) 联系方式： Email: [email protected] QQ: 32460746 本自由代码（JavaScript版本）遵照GPL标准和Open Source之精神，原则上免费为全世界任何编程人员 使用、修改、重写成其他编程语言和重新发布，但希望您在进行以上行为时，出于对本代码原创发起者 的艰辛劳动的尊重与肯定，敬请保留这段简短的版权信息，谢谢！ ________________________________________________________________________ ########################################################################## 2.关于中国日历类（CCC-v0.1-js） 很多年前，还在上中学的时候，我就开始对天文和历法感兴趣，既佩服西洋历法之简捷精准，又尝惊叹中国传统农历之巧妙，尤其是无中气置闰法。在中国传统文化 的魅力和西方现代科学的双重影响下，我便开始试着将中国农历，干支，节气等等公式化，要知道古人往往用口诀代替公式，如推月干支、时干支的口诀，这不容易 记忆，也不能反映出道理来。现在看来，这些早期的工作竟然使我能够在E时代借助于电脑和网络来实现万年历。 差不多前年（2002年）的这个时候，我刚刚开始自学做网页，学完HTML后又对脚本语言JavaScript感兴趣，于是自己边学边动手按照自己的意图编写程序，开始时每次出错都让自己焦躁不安，但每次成功也都使我激动不已。就这样，我在动手实践中（这相当重要），我逐渐熟练了JavaScript编程，甚至能编写较大型的程序了，如那年10月假期期间我独立的编写出俄罗斯方块游戏，虽然我已经发现网上还有更优秀的脚本，但对于什么都没有参考的我来说，算是很有成就感了。 我早就想编一个万年历的程序放 在网上，前年刚学完JavaScript是曾编了一个的，凑合能用，但算法麻烦，每一年的农历信息需要17个数来确定，另外节气计算公式也有点错误。后 来，我偶然在网上发现了由台湾的林洵贤先生编写的（后来由大陆的梅竹松修正）经典的200年JavaScript万年历，大大小小的网站许多都用了林先生 的年历（但有的竟没说明版权），当时十分叹服。觉得自己和别人毕竟差了好大一截。终于在去年4月-5月，我利用课余时间花了一个多月的时间自己写了一个功 能比较齐全的万年历，适用年数近三千年，除了阴历和阳历之外，还有儒略日、年代纪元、干支、日月食、节气交节时刻、黄道星座、各种节日（包括九九、三伏、 梅雨）、人体生物钟、倒计时以及日记等功能，算法与林先生的截然不同，并且功能与准确度也是非林先生的万年历所能及的，如正规历书上记载1985年春分是 3月21日，这与本年历计算结果完全一致，而林先生的万年历则给出是3月20日，其原因是我的算法考虑了岁差与章动，而林先生的则是用平节气的简单算法。 当时我把这个万年历叫做“知来者”，取自《周易・说卦传》孔子所说的“数往者顺，知来者逆”。刚做完不久，我就在北京大学未名BBS的网页设计 （HomePage）板公开了全部源代码及相关注释。不少网友试用了“知来者”，给予我大力支持和鼓励，同时也提出了一些问题和建议，主要是速度较慢、个 别农历日期有误以及界面可以再美化一些。然而其时我已没更多时间和精力了，所以也就一直拖了下去。 直到最近（整整一年之后），也就是在北京的这个“非典时期”，学校暂时停课，我才得以有时间重新修正我的万年历，不但纠正了原有的错误，而且又增加 了一些功能，如历种的转化、甲子纳音、二十八星宿、世界时区等，增添了节日。然而，最为重要的是，我产生了构建“中国日历类”的想法。也就是说，我将我已 经做好的所有关于中国日历的函数全部封装在一个叫做“中国日历类”（Chinese Calendar Class，简称CCC）里，这样，以后别人在需要用到有关中国日历的某种函数时（如求某年某月某日的农历日期，或是求几月几号有什么节日等等），就不必 自己动手去编写代码了，而直接从CCC中取出来就行了，其容易程度就象是从光盘盒中取光/盘一样简单。 终于，又花了几天功夫，我终于基本实现了CCC的构建，并利用它重新写了一个在线万年历，不但纠正了以前的几处错误、增加了一些功能，而且速度和界面都有了改观。 最后，应当感谢曾次亮先生和Erling Poulsen，曾先生几十年的辛苦劳动使我得以将他的节气计算方法公式化，而我的朔望交食程序则是在Erling Poulsen的程序上加以简化和应用的。另外，波波网友细心地指出了1901-2050年个别农历日期的错误，在此也表示感谢。 二、中国日历类JavaScript版本（CCC-v0.1-js）的使用方法 1.所包含的源代码文件 所有源文件都在ccc0.1目录下，包括ccc.js, math.js, solar.js, sterm.js, ganzhi.js, lunar.js, string.js, ftvl.js, era.js和timezone.js。 注意：在引用时，ccc0.1目录必须与引用的文件在同一目录下，并且不能更改ccc目录名。比如，C:\mypages目录下的calendar.htm要引用CCC，则可以将ccc目录放到C:\mypages下，并在源文件中加入： <script language="JavaScript" src="ccc0.1/ccc.js"></script> 即可。 2.新建一个CCC对象 直接用new方法新建一个CCC对象，即 var cccObject=new CCC(year,month,date,time,zone,calType); 其中 year（年）=正负整数，（ 0是公元前1年，-1是公元前2年等等） month（月）=1 -12 date（日）=正负整数 time=形如"22:30:15"（表示22时30分15秒）的字符串 zone（世界时区）= -12 - +13 （负表示西时区，正表示东时区） calType（历种）=1,2,3 分别代表Normal（标准公历）,Gregorian（格里历）,Julian（儒略历） 也可以采用较少的参数新建对象： 三参数 var cccObject=new CCC(year,month,date) 四参数 var cccObject=new CCC(year,month,date,time) 四参数 var cccObject=new CCC(year,month,date,calType) 五参数 var cccObject=new CCC(year,month,date,time,calType) 六参数 var cccObject=new CCC(year,month,date,time,zone,calType) 其中time,zone和calType的缺省值是"0:0:0",8和1。 示例： var myCal=new CCC(2003,5,8,"14:19:50",8,1); 3.CCC对象的方法 出于代码执行速度的考虑，CCC对象没有采用属性而只赋予方法，因为在JavaScript中一旦新建一个对象,就必须同时初始化其所有属性，而这是一件 不太明智的事情，因为当我们只想取得CCC的某一两个属性时，没有必要将它的所有其他属性都一一初始化一遍。因而我决定将所有CCC的一些性质都用相应的 方法来取得。 到目前为止，这些性质和方法分成三组（同样是出于代码执行速度的考虑）： 1) CCC对象下的直接的方法 语法是： cccObject.methodName() 如： myCal.day()返回myCal对象的星期数 CCC-v0.1-js的直接的方法如下： 方法 返回值 year() 年份数 month() 月份数 date() 日期数 time() 时间字符串 hour() 小时数 minute() 分钟数 second() 秒数 zone() 世界时区数 calType() 日历类型数 calType_Str() 日历类型字符串 JulianDay() 儒略日 day() 星期数 day_Str() 星期字符串（汉语） day_ENStr() 星期字符串（英语） solarZodiac() 十二星座数 solarZodiac_Str() 十二星座字符串 yGz() 年干支数 yGz_Str() 年干支字符串 mGz() 月干支数 mGz_Str() 月干支字符串 dGz() 日干支数 dGz_Str() 日干支字符串 hGz() 时干支数 hGz_Str() 时干支字符串 chineseZodiacName() 生肖字符串 chineseEra() 年代纪元字符串 stars28() 二十八宿数 stars28_Str() 二十八宿字符串 sFtvl() 公历节日字符串 jqFtvl() 节气节日字符串 monthLength() 阳历本月长度（天数） monthLength_Str() 阳历本月长度（月大月小字符串） 2) CCC对象的节气子类的方法 首先建立CCC对象的节气子类对象： var sTerm=cccObject.solarTerm(); 节气子类对象的属性（注意不是方法！）有两个： sTermInMonth ―― 一个字符串数组，包含所在阳历月的两个节气日期和交节时刻 sTermName ―― 当前日期的节气名，若当天不是节气日，则是空字符串 sTermTime ―― 当前日期的节气交节时刻，若当天不是节气日，则是空字符串 示例： 如：sTerm.sTermInMonth[0] 3) CCC对象的农历子类的方法 首先建立CCC对象的农历子类对象： var myLunarCal=cccObject.lunar(); 农历子类对象的属性（注意不是方法！）有： 属性 值 lunarDate 农历日期数 lunarDate_Str 农历日期字符串 lunarMonth 农历月份数 lunarMonth_Str 农历月份字符串 syzygyType 朔望类型数 syzygyTime 朔望时刻（单位：天） syzygyTime_Str 朔望时刻（字符串 syzygyName 朔望名称字符串 ecliType 日月食类型数 ecliType_Str 日月食类型字符串 ecliTime 日月食发生时刻（单位：天） ecliTime_Str 日月食发生时刻（字符串） 示例： 如：myLunarCal.lunarDate_Str 三、进一步说明 1.公历（西历） 按照习惯，公元1582年10月4日之前（包括10月4日），采用儒略（Julian）历，公元1582年10月15日之后（包括10月15日），采用格 里（Gregorian）历，公元1582年10月5日到10月14日，是格里历中被删掉的十天，故本年历无此十天。 2.农历 现行农历采用的是夏历（即建寅为正），所以本年历主要采用夏历，但由于历史上改朝换代或君王改换纪元等原因，曾有多次修改月建，在本年历中未作特别说明，现说明如下： i)公元前256年（秦襄昭王52年）采用秦历，此前一直采用古周历（但春秋战国时各国历法不一，较为混乱）。秦历以十月为岁首，“后九月”为闰月。 ii)公元前105年，西汉太初元年五月改历，以正月为岁首，该年有十五个月（从十月、十一月、十二月、一月、二月、......十二月）。 iii)公元9年，新朝王莽始建国1年，以12月为正月（丑月），故上一年无“十二月”。 iv)公元23年，淮阳王改元更始，复用因寅正，以地皇十一月为更始1年的十月，故是年有两个十月。 v)三国魏青龙5年（公元237年）三月，改元景初，建丑为正，以三月为四月，四月为五月，...，十二月为正月。而景初三年十二月，魏复寅正，故是年有两个十二月。 vi)周武则天天授一年（载初1年，公元689年）十一月，该行周历子正。以十一月为岁首，该为载初1年正月，故乙丑年只有十个月。 vii)久视1年十月复寅正，以正月为十一月，故是年有14个月。 viii)唐上元2年（公元761年）九月去年号，但称元年。以建子为正，月以所建辰为名，原十月称亥月，原十一月称子月（岁首），...，原三月为辰月。而建巳月复寅正，恢复原月名，仍称四月。故辛丑年无十一月、十二月。壬寅年有十四个月。另外，应当指出，本年历采用的都是实朔，而从春秋战国一直到唐初用的都是平朔，所以有在阴历日期上会有一日之差，应当说这是古人的不足。不过，古人常用日月食来校正日期（所谓观象授时），因而此时与本年历是吻合的。 3.干支 根据古代术数，年干支以立春为界，而月干支按节气月（从立春到雨水为一月，余类推）赋予，日干支以子时（从现代时间23时开始）为界。 4.节气 本年历的节气全部采用定节气（最大误差不超过30分钟），但应注意我国古代历法知道清初才采用定节气，之前一直用平节气。 5.朔望交食 最大误差为3分钟，遇到日月食时，朔望时间可视为食甚时刻。由于所用时间均为北京时间，故他地须作时差转换，各地应根据日出日落时间来判断日月食能否看到。 6.生肖星座 生肖按年地支推出，故也以立春为界。十二星座可能在名称或日期范围上与有些资料不一致，但目前的状况确实如此。 7.儒略日(Julian Day)本年历的儒略日精确到时，以儒略历公元前4713年1月1日格林尼治时间正午12时为起点。 8.各种节日 公历节日，传统节日和名人纪念日，以及冬九九，夏三伏，梅雨季节等，但夏三伏，梅雨等等有不同说法，本年历按最常见的习惯制定。 四、实例应用――在线万年历 我的一个直接运用CCC编写的在线万年历的例子 见Cal.htm或http://202.112.86.128/studentspace/aqyw/js/calendars/rili/cal.htm 五、作者的希望 如果您有志于为中国日历类（CCC）做出自己的一分努力，那么就十分希望您能不断地宣传、交流甚或进一步完善摆在你面前的目前作者的这份阶段性工作。尤其是年代纪元，由于时间关系，我只输入至隋朝，但这已经把我弄得疲惫不堪了，我真希望谁能继续把这项工作做完。在附件中我附上我国历史年表，大家可以参考。 ★★★ 下载地址 ★★★ http://202.112.86.128/studentspace/aqyw/js/calendars/rili/

 ·加拿大留学移民 求教双护照回国策略
 ·汽车 澳洲驾照可以在国内使用吗？
·中文新闻 艾玛·洛弗尔：一名妇女的丈夫在一次暴力入室盗窃中被刺伤，