[2010-09-20].NET 2.0 C#下利用ChineseLunisolarCalendar類農曆的實現

題外話：第一次在CSDN上發日誌文章，因爲一直在用的QQ空間和163博客都不支持代碼段的插入，畢竟大家的定位也不同，QQ和163定位於門戶性社區，所以以後還是儘量把技術性的東西往技術性社區放好了。

 

好了，言歸正傳，農曆的實現一般都是自己寫代碼計算相關的時差，.NET 2.0則提供了一個農曆的類庫（看來微軟終於發現中國的存在了）。這個類庫在System.Globalization命名空間下，名稱是ChineseLunisolarCalendar，這個類引用MSDN上的原文解釋爲：

將時間分成多個部分來表示，如分成年、月和日。年按農曆計算，而日和月按陰陽曆計算。

呵呵，“日和月按陰陽曆計算”，不知道是什麼意思，反正最終出來的計算結果是對的，我也沒有深究。

 

ChineseLunisolarCalendar類提供了方法直接把當前日期換算成農曆。

如常用的：

GetYear():返回了一個1到60之間的整數，至於爲什麼是1到60，有興趣的可以自行了解一下農曆的計算原理或者研究一下命理測算（估計研究完這個你就不用程序展示農曆給你看，自己能心算了。）

GetMonth():返回一個 1 到 13 之間的整數，同理的研究一下農曆計算原理或跟算命的瞭解一下，就知道爲什麼農曆會有13個月。

GetDayOfMonth():返回一個從 1 到 31 的整數。

還有一些與Leap相關的方法和屬性是與閏月相關的，也會經常用到。

下面看一下實際代碼：

using System; using System.Collections.Generic; using System.Text; using System.Globalization; using System.Collections; namespace LunarCalendar { public class C_LunarCalendar { /// <summary> /// 農曆年份 /// </summary> private static String[] ChinaYear = new String[]{ "甲子","乙丑","丙寅","丁卯","戊辰","己巳","庚午","辛未","壬申","癸酉","甲戌","乙亥", "丙子","丁丑","戊寅","己卯","庚辰","辛巳","壬午","癸未","甲申","乙酉","丙戌","丁亥", "戊子","己丑","庚寅","辛卯","壬辰","癸巳","甲午","己未","丙申","丁酉","戊戌","己亥", "庚子","辛丑","壬寅","癸卯","甲辰","乙巳","丙午","丁未","戊申","己酉","庚戌","辛亥", "壬子","癸丑","甲寅","乙卯","丙辰","丁巳","戊午","己未","庚申","辛酉","壬戌","癸亥" }; /// <summary> /// 農曆月份 /// </summary> private static String[] ChinaMonth = new String[]{ "元", "二", "三", "四", "五", "六", "七", "八", "九", "十", "十一", "臘" }; /// <summary> /// 農曆日期 /// </summary> private static String[] ChinaDay = new String[]{ "初一", "初二", "初三", "初四", "初五", "初六", "初七", "初八", "初九", "初十", "十一", "十二","十三", "十四" ,"十五", "十六","十七", "十八" ,"十九", "二十", "廿一", "廿二","廿三", "廿四" ,"廿五", "廿六","廿七", "廿八" ,"廿九", "三十" }; /// <summary> /// 十二生肖 /// </summary> private static String[] ChinaZodiac = new String[] { "鼠", "牛", "虎", "兔", "龍", "蛇", "馬", "羊", "猴", "雞", "狗", "豬" }; private static Hashtable aChinaFestival_LC = new Hashtable(); /// <summary> /// 農曆類對象 /// </summary> private static ChineseLunisolarCalendar aLunisolarCalendar_C = new ChineseLunisolarCalendar(); /// <summary> /// 錯誤信息 /// </summary> private static String aErrMsg = ""; /// <summary> /// 農曆的年 /// </summary> private static Int32 aYear_Lc; /// <summary> /// 農曆的月 /// </summary> private static Int32 aMonth_Lc; /// <summary> /// 農曆的日 /// </summary> private static Int32 aDay_Lc; public static String ErrMsg { get { return aErrMsg; } } static C_LunarCalendar() { aChinaFestival_LC.Add("臘三十", "除夕"); aChinaFestival_LC.Add("元初一", "春節"); aChinaFestival_LC.Add("元十五", "元宵"); aChinaFestival_LC.Add("四十六", "清明"); aChinaFestival_LC.Add("五初五", "端午"); aChinaFestival_LC.Add("七初七", "七夕"); aChinaFestival_LC.Add("九初九", "重陽"); aChinaFestival_LC.Add("七十五", "中元"); aChinaFestival_LC.Add("八十五", "中秋"); aChinaFestival_LC.Add("臘初八", "臘八"); } public static Boolean GetLunisolarCalendarForChina(DateTime CurrentDateTime,out String DateTime_LC) { DateTime_LC = ""; if (CurrentDateTime > aLunisolarCalendar_C.MaxSupportedDateTime || CurrentDateTime < aLunisolarCalendar_C.MinSupportedDateTime) { aErrMsg = "不被支持的日期！"; return false; } aYear_Lc = aLunisolarCalendar_C.GetYear(CurrentDateTime); aMonth_Lc = aLunisolarCalendar_C.GetMonth(CurrentDateTime); aDay_Lc = aLunisolarCalendar_C.GetDayOfMonth(CurrentDateTime); Boolean iIsLeap = aLunisolarCalendar_C.IsLeapMonth(aYear_Lc, aMonth_Lc); if (iIsLeap) aMonth_Lc -= 1; StringBuilder iChinaDateTimeStr = new StringBuilder(); Int32 iYearID = (aYear_Lc - 4) % 60; iChinaDateTimeStr.Append(ChinaYear[iYearID]); iChinaDateTimeStr.Append("年 "); if (iIsLeap) iChinaDateTimeStr.Append("閏" + ChinaMonth[aMonth_Lc - 1] + "月 "); else iChinaDateTimeStr.Append(ChinaMonth[aMonth_Lc - 1] + "月 "); iChinaDateTimeStr.Append(ChinaDay[aDay_Lc - 1]); DateTime_LC = iChinaDateTimeStr.ToString(); return true; } /// <summary> /// 取指定日期的農曆日 /// </summary> /// <param name="CurrentDateTime">當前日期</param> /// <param name="IfRetMonthInFistDay">如果爲月份的第一天是否返回月份字符串</param> /// <param name="IfRetFestival">是否返回節日（比月份優先返回）</param> /// <returns></returns> public static String GetLCDayForChina(DateTime CurrentDateTime, Boolean IfRetMonthInFistDay, Boolean IfRetFestival) { if (CurrentDateTime > aLunisolarCalendar_C.MaxSupportedDateTime || CurrentDateTime < aLunisolarCalendar_C.MinSupportedDateTime) { aErrMsg = "不被支持的日期！"; return ""; } String iMonthStr; aDay_Lc = aLunisolarCalendar_C.GetDayOfMonth(CurrentDateTime); if (IfRetFestival) { iMonthStr = GetLCMonthForChina(CurrentDateTime); if (aChinaFestival_LC.Contains(iMonthStr + ChinaDay[aDay_Lc - 1])) return aChinaFestival_LC[iMonthStr + ChinaDay[aDay_Lc - 1]].ToString(); } if ((aDay_Lc == 1) && IfRetMonthInFistDay) { iMonthStr = GetLCMonthForChina(CurrentDateTime); if (aLunisolarCalendar_C.IsLeapMonth(CurrentDateTime.Year, CurrentDateTime.Month)) return String.Format("閏{0}月", iMonthStr); else return String.Format("{0}月", iMonthStr); ; } return ChinaDay[aDay_Lc - 1]; } /// <summary> /// 取指定日期的農曆年 /// </summary> /// <param name="CurrentDateTime">當前日期</param> /// <returns></returns> public static String GetLCYearForChina( DateTime CurrentDateTime ) { if (CurrentDateTime > aLunisolarCalendar_C.MaxSupportedDateTime || CurrentDateTime < aLunisolarCalendar_C.MinSupportedDateTime) { aErrMsg = "不被支持的日期！"; return ""; } Int32 iYear = aLunisolarCalendar_C.GetYear(CurrentDateTime); iYear = (iYear - 4) % 60; return ChinaYear[iYear]; } /// <summary> /// 取指定日期的農曆月 /// </summary> /// <param name="CurrentDateTime">當前日期</param> /// <returns></returns> public static String GetLCMonthForChina(DateTime CurrentDateTime) { if (CurrentDateTime > aLunisolarCalendar_C.MaxSupportedDateTime || CurrentDateTime < aLunisolarCalendar_C.MinSupportedDateTime) { aErrMsg = "不被支持的日期！"; return ""; } Int32 iMonth = aLunisolarCalendar_C.GetMonth(CurrentDateTime); Int32 iYear = aLunisolarCalendar_C.GetYear(CurrentDateTime); Boolean iLeapYear = aLunisolarCalendar_C.IsLeapYear(iYear); if (iLeapYear) { Int32 iLeapMonth = aLunisolarCalendar_C.GetLeapMonth(CurrentDateTime.Year); if (iMonth >= iLeapMonth) iMonth--; } return ChinaMonth[iMonth - 1]; } /// <summary> /// 取指定年的生肖 /// </summary> /// <param name="CurrentDateTime">指定年的日期</param> /// <returns></returns> public static String GetLCYearZodiac(DateTime CurrentDateTime) { if (CurrentDateTime > aLunisolarCalendar_C.MaxSupportedDateTime || CurrentDateTime < aLunisolarCalendar_C.MinSupportedDateTime) { aErrMsg = "不被支持的日期！"; return ""; } Int32 iYear = aLunisolarCalendar_C.GetSexagenaryYear(CurrentDateTime); iYear = aLunisolarCalendar_C.GetTerrestrialBranch(iYear); return ChinaZodiac[iYear - 1]; } } }

 

這個類並沒有整理過，只是要用什麼才隨便寫個方法，所以代碼比較亂。

 

利用這個類，做了一個農曆月曆，效果如下：

 

 

 

月曆上可以看出，沒有傳統節日，以後會加上。

另外也提前祝大家中秋節快樂，閤家團圓！

 

2010-12-03

+個下載地址：

http://download.csdn.net/source/2880958