基姆拉爾森公式(Kim Larsen Formula)是通過純數學運算計算星期幾的經典算法,無需依賴日期庫。本文提供 C# 完整實現,解析公式原理、月份調整規則、返回值映射,並給出調用示例。
W = (d + 2*m + 3*(m+1)/5 + y + y/4 - y/100 + y/400) % 7
d:日(1-31)m:月(3=3月 ... 14=翌年2月)y:年(若月份為 1 或 2,視作上一年的 13、14 月,年份 -1)W:0=周一 ... 6=周日(或按需映射)public static string CalculateWeekDay(int year, int month, int day) {
// 關鍵:1、2 月視作上一年 13、14 月
if (month == 1) { month = 13; year--; }
else if (month == 2) { month = 14; year--; }
int week = (day + 2 * month + 3 * (month + 1) / 5 + year + year / 4 - year / 100 + year / 400) % 7;
// 映射:公式結果 0=周一 ... 6=周日
string[] weeks = { "星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日" };
return weeks[week];
}
// WebForms 標籤顯示
Label1.Text = CalculateWeekDay(2004, 12, 9); // 輸出:星期四
// 控制台測試
Console.WriteLine(CalculateWeekDay(2024, 1, 1)); // 星期一
Console.WriteLine(CalculateWeekDay(2024, 2, 29)); // 星期四 (閏年)
Console.WriteLine(CalculateWeekDay(2000, 2, 29)); // 星期二 (世紀閏年)
| 日期 | 預期 | 實際 | 說明 |
|---|---|---|---|
| 1900-01-01 | 星期一 | 星期一 | 非閏年世紀 |
| 2000-01-01 | 星期六 | 星期六 | 閏年世紀 |
| 2024-02-29 | 星期四 | 星期四 | 閏年 |
| 1999-12-31 | 星期五 | 星期五 | 年末 |
// 推薦生產環境使用
DateTime dt = new DateTime(2004, 12, 9);
string week = dt.ToString("dddd", new CultureInfo("zh-CN")); // "星期四"
// 或
string week2 = dt.DayOfWeek.ToString(); // "Thursday" 需自行映射中文
內置方法處理了曆法切換(格里高利曆)、時區、本地化等複雜性,性能極高且經過充分測試。公式法適合嵌入式、無標準庫環境或教學演示。
另一經典公式(Zeller's Congruence),結果 0=周六:
int h = (day + (13*(month+1))/5 + year + year/4 - year/100 + year/400) % 7;
// 月份同樣 3=3月 ... 14=2月
基姆拉爾森公式以整數運算高效計算星期幾,C# 實現簡潔易懂。理解「1、2 月屬上一年」的月份調整規則是正確應用的關鍵。實際項目中優先使用 DateTime.DayOfWeek,公式作為算法原理學習或受限環境備選。