萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實作天干地支計算器:農曆年份干支轉換演算法詳解

天干地支(簡稱「干支」)是中國傳統紀年法,由十天干(甲、乙、丙、丁、戊、己、庚、辛、壬、癸)與十二地支(子、丑、寅、卯、辰、巳、午、未、申、酉、戌、亥)組合成六十甲子循環。本文提供兩種 PHP 演算法實作,可快速計算任一西元年份對應的干支紀年。

干支基礎知識

  • 十天干:甲、乙、丙、丁、戊、己、庚、辛、壬、癸
  • 十二地支:子、丑、寅、卯、辰、巳、午、未、申、酉、戌、亥
  • 依序配對形成 60 個基本單位(六十甲子),循環往複
  • 古代用於紀日、紀月、紀年、紀時

演算法一:基於 1900 年基準偏移

以 1900 年為庚子年(索引 36),計算目標年份與 1900 年的差值,取模 10 與 12 分別對應天干、地支陣列:

<?php
$TGDZ = array(
    array('甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'),
    array('子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥')
);

$year = 2014;
$offset = $year - 1900 + 36;  // 1900 年對應索引 36
$gan = $TGDZ[0][$offset % 10];
$zhi = $TGDZ[1][$offset % 12];

echo "{$year} 年為農歷【{$gan}{$zhi}】年";
// 輸出:2014 年為農歷【甲午】年
?>

演算法二:直接以年份取模(1900-2099 年適用)

觀察規律:1900 年為庚子,天干索引 0、地支索引 0,故可直接用年份 % 10、% 12:

<?php
$TGDZ = array(
    array('庚', '辛', '壬', '癸', '甲', '乙', '丙', '丁', '戊', '己'),
    array('申', '酉', '戌', '亥', '子', '丑', '寅', '卯', '辰', '巳', '午', '未')
);

for ($year = 1900; $year <= 2099; $year++) {
    $gan = $TGDZ[0][$year % 10];
    $zhi = $TGDZ[1][$year % 12];
    echo "{$year} 年為農歷【{$gan}{$zhi}】年<br>";
}
?>

陣列排列原理說明

演算法二的陣列順序經過旋轉調整,使 $year % 10、$year % 12 直接對應正確干支。此技巧利用模算術特性,省去基準年計算,程式碼更簡潔。

擴充應用建議

  • 封裝為函數 getGanZhi($year) 供專案複用
  • 結合農曆新年日期判斷,精確到月、日干支
  • 整合節氣計算,打造完整萬年曆功能

兩種演算法各有優勢:演算法一邏輯清晰易懂,適合教學;演算法二程式碼極簡,適合 1900-2099 年區間的快速部署。開發者可根據需求選擇。

copyright © 萬盛學電腦網 all rights reserved