萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 計算星期幾:基姆拉爾森公式完整實現與調用示例

基姆拉爾森公式(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=周日(或按需映射)

C# 實現

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星期五星期五年末

對比:.NET 內置方法

// 推薦生產環境使用
DateTime dt = new DateTime(2004, 12, 9);
string week = dt.ToString("dddd", new CultureInfo("zh-CN")); // "星期四"
// 或
string week2 = dt.DayOfWeek.ToString(); // "Thursday" 需自行映射中文

內置方法處理了曆法切換(格里高利曆)、時區、本地化等複雜性,性能極高且經過充分測試。公式法適合嵌入式、無標準庫環境或教學演示。

擴展:Zeller 公式

另一經典公式(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,公式作為算法原理學習或受限環境備選。

copyright © 萬盛學電腦網 all rights reserved