天干地支(簡稱「干支」)是中國傳統紀年法,由十天干(甲、乙、丙、丁、戊、己、庚、辛、壬、癸)與十二地支(子、丑、寅、卯、辰、巳、午、未、申、酉、戌、亥)組合成六十甲子循環。本文提供兩種 PHP 演算法實作,可快速計算任一西元年份對應的干支紀年。
以 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 年為庚子,天干索引 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 年區間的快速部署。開發者可根據需求選擇。