現代人多不諳農曆,在網頁顯示農曆不僅實用,更能傳承文化。.NET Framework 內建 System.Globalization.ChineseLunisolarCalendar 類別,提供完整農曆轉換功能,無需第三方庫。
public partial class ChineseDatePage : System.Web.UI.Page {
private static readonly ChineseLunisolarCalendar calendar = new ChineseLunisolarCalendar();
private static readonly string ChineseNumber = "〇一二三四五六七八九";
public const string CelestialStem = "甲乙丙丁戊己庚辛壬癸"; // 十天干
public const string TerrestrialBranch = "子丑寅卯辰巳午未申酉戌亥"; // 十二地支
public static readonly string[] ChineseDayName = {
"初一","初二","初三","初四","初五","初六","初七","初八","初九","初十",
"十一","十二","十三","十四","十五","十六","十七","十八","十九","二十",
"廿一","廿二","廿三","廿四","廿五","廿六","廿七","廿八","廿九","三十"
};
public static readonly string[] ChineseMonthName = {
"正","二","三","四","五","六","七","八","九","十","十一","十二"
};
// ... 頁面載入與輸出邏輯
}
public string GetChineseDate(DateTime time) {
string y = GetYear(time);
string m = GetMonth(time);
string d = GetDay(time);
string sb = GetStemBranch(time);
return $"{y}({sb})年 {m}月 {d}";
}
public string GetStemBranch(DateTime time) {
int sexagenaryYear = calendar.GetSexagenaryYear(time); // 1~60
// 取模運算對應天干地支索引 (0-based)
char stem = CelestialStem[(sexagenaryYear % 10) - 1];
char branch = TerrestrialBranch[(sexagenaryYear % 12) - 1];
return $"{stem}{branch}";
}
public string GetYear(DateTime time) {
var sb = new StringBuilder();
int year = calendar.GetYear(time);
do {
sb.Insert(0, ChineseNumber[year % 10]);
year /= 10;
} while (year > 0);
return sb.ToString();
}
public string GetMonth(DateTime time) {
int month = calendar.GetMonth(time);
int year = calendar.GetYear(time);
int leap = 0;
// 正月不可能閏月,從 3 月開始檢查
for (int i = 3; i <= month; i++) {
if (calendar.IsLeapMonth(year, i)) { leap = i; break; }
}
if (leap > 0) month--; // 閏月後的月份序數減一
return (leap == month + 1 ? "閏" : "") + ChineseMonthName[month - 1];
}
public string GetDay(DateTime time) {
return ChineseDayName[calendar.GetDayOfMonth(time) - 1];
}
<table>
<tr><td><%= ForignTimeNow %></td></tr> <!-- 公曆 -->
<tr><td><%= ChineseTimeNow %></td></tr> <!-- 農曆 -->
</table>
ChineseLunisolarCalendar 支援範圍:1901/02/19 ~ 2100/01/31DateTimeFormatInfo 實現多語系日期格式化幾行代碼即可接入傳統曆法,展現 .NET 框架國際化支援的深度。建議封裝為獨立元件(ChineseDateHelper),供全專案複用。