zakuro 0.8.0 → 0.9.1

data/doc/usage.md

@@ -0,0 +1,120 @@
+# 使用方法
+
+使用例は後述しております。
+
+## 手順
+
+### 条件設定
+
+期待する結果を得るためには、適切な条件を渡す必要があります。
+
+条件はHash型で渡します。
+
+```
+require 'zakuro'
+
+# 初期化時の設定
+merchant = Zakuro::Merchant.new(condition: { date: Date.new(862, 2, 3) })
+```
+
+詳細は、 [条件](./condition.md) を参照してください。
+
+### 条件再設定
+
+一度設定した条件を書き換えることが可能です。
+
+```
+# 再設定
+merchant.offer(condition: { date: western_date })
+
+# 条件を指定しない初期化
+merchant = Zakuro::Merchant.new
+
+# 後付けで条件を設定する
+merchant.offer(condition: { date: western_date })
+```
+
+### 結果取得
+
+#### JSON（整形なし）
+```
+puts merchant.commit.to_json
+# => {"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}}}}
+```
+
+#### JSON（整形あり）
+
+行数が多いため結果は省略します。
+```
+puts merchant.commit.to_pretty_json
+# => {
+  "data": {
+    "year": {
+      "first_gengou": {
+        "name": "貞観",
+        "number": 4
+      },
+      "second_gengou": {
+        "name": "",
+        "number": -1
+      },
+      "zodiac_name": "壬午",
+      "total_days": 354
+    },
+# 中略
+  }
+}
+```
+
+## 使用例
+
+### 一日検索（西暦 -> 和暦）
+
+```
+require 'zakuro'
+
+# 条件となる西暦日を準備する
+western_date = Date.new(862, 2, 3)
+
+# ざくろ商人（Zakuro::Merchant）に西暦日を渡す
+merchant = Zakuro::Merchant.new(condition: { date: western_date })
+
+# 結果の和暦日を取得する
+puts merchant.commit.to_json
+# => {"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}}}}
+
+```
+
+### 一日検索（和暦 -> 和暦）
+
+```
+require 'zakuro'
+
+# 条件となる和暦日を準備する
+japan_date = '貞観4年1月1日'
+
+# ざくろ商人（Zakuro::Merchant）に和暦日を渡す
+merchant = Zakuro::Merchant.new(condition: { date: japan_date })
+
+# 結果の和暦日を取得する
+puts merchant.commit.to_json
+# => {"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}}}}
+```
+
+### 範囲検索（西暦 -> 和暦）
+
+```
+merchant = Zakuro::Merchant.new(condition: { range: {start: Date.new(862, 2, 3), last: Date.new(862, 2, 4)
+} })
+
+puts merchant.commit.to_json
+# => {"list":[{"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}}}},{"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":2,"zodiac_name":"辛未","remainder":"7-1282","western_date":"0862-02-04"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":2,"zodiac_name":"辛未","remainder":"7-1282","western_date":"0862-02-04"},"options":{}}}}]}
+```
+
+### 範囲検索（和暦 -> 和暦）
+
+```
+merchant = Zakuro::Merchant.new(condition: { range: {start: '貞観4年1月1日', last: '貞観4年1月2日' } })
+puts merchant.commit.to_json
+# => {"list":[{"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"options":{}}}},{"data":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":2,"zodiac_name":"辛未","remainder":"7-1282","western_date":"0862-02-04"},"options":{}},"operation":{"operated":false,"month":{"current":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]},"parent":{"id":"","western_date":"","page":-1,"number":-1,"annotations":[]}},"original":{"year":{"first_gengou":{"name":"貞観","number":4},"second_gengou":{"name":"","number":-1},"zodiac_name":"壬午","total_days":354},"month":{"number":1,"leaped":false,"days_name":"大","first_day":{"number":1,"zodiac_name":"庚午","remainder":"6-1282","western_date":"0862-02-03"},"odd_solar_terms":[{"index":5,"remainder":"34-5368"}],"even_solar_terms":[{"index":4,"remainder":"19-3532"}]},"day":{"number":2,"zodiac_name":"辛未","remainder":"7-1282","western_date":"0862-02-04"},"options":{}}}}]}
+```

data/doc/vanished_date.md

@@ -0,0 +1,86 @@
+# 滅日
+
+没日を端的に説明すると、1朔望月（29.5..日）を30日で表わすために、一定の法則で `不足した日` として配置された日である
+
+経朔（平均値で求めた月初日）をもとに計算を行う
+
+## 計算
+### 宣明暦
+「長慶宣明暦算法」に従う
+
+下記は該当箇所の引用と、それに対応する計算を示している
+
+```
+◯滅日ヲ求ルノ術
+```
+
+```
+経朔之小余朔虚分ノ三千九百四十三ヨリ巳下ハ者之ヲ置キテ三十ヲ以テ之ヲ乗シ朔虚分ヲ以テ之ヲ除シ商ヲ以テ日ト為ス経朔ノ大余ヲ加フ甲子ヨリ命スル事右ノ如シ
+```
+
+* 滅日あり
+  * 経朔の小余 < 3943
+* 計算方法
+  * (経朔の小余 * 30) / 3943 = 大余（正数） ... A
+  * (経朔の小余 * 30) % 3943 = 小余        ... B
+* 滅余
+  * (A + 経朔の大余) % 60 = 大余
+  * B = 小余
+
+```
+第一段ノ経朔ノ小余ノ數三千九百四十三ヨリ少クハ滅日ヲ求メヨト云フナリ則チ己丑ノ十二月ノ小余三百二十アリコレ朔虚分ノ數ヨリ少キ故ニ滅日ヲ求ムコノ三百二十置キテ三十ヲ以テ乗スレハ九千六百トナルコレヲ朔虚分ノ三千九百四十三ニテワレハ商ニトナリ不盡一千七百一十四アリ此ノ商ニニ経朔ノ大余二十二ヲクワエテ滅日ノ大余二十四小余一千七百十四トナルモシ経朔ノ大余ヲ加エテ甲子ノ六十にミツレハコレヲ去モシ小余ニ三十ヲ乗ソモ朔虚分ノ數ニタラサル時ハ経朔ノ大余ヲ直ニ用ユヘシ支干ヲ付ルフツ子ノ如ク紀法ノ圖ニテモトムヘシ二十四ハ戊子ナリ
+```
+
+* 経朔: 大余22小余320
+* 滅日あり
+  * 320 < 3943
+* 計算
+  * 30 * 320 = 9600
+  * 9600 / 3943 = 2
+  * 9600 % 3943 = 1714
+* 滅余
+  * (2 + 22) % 60 = 24
+  * 1714
+
+```
+大余ニ二　小余ニ三千五百九十一
+```
+
+* 大余2小余3591
+
+```
+滅日ノ大小余ニ此ノ如ク加フレハ其次ノ滅日ノ大小余トナルモシクワエテ大余甲子ノ六十ニナレハ減去ス又小余朔虚分ノ三千九百四十三ニナレハ減去シテ大余三ヲ加フヘシサテ滅日ノアル月ハ経朔ノ小余朔虚分ノ數ヨリ以下ノ處ナリ
+```
+
+* 次の滅余
+  * (小余1714 + 小余3591) % 3943 = 1362
+  * (大余24 + 大余2 + 繰り上げ1) % 60 = 27
+
+## 大衍暦
+『歴代天文律暦等志彙編　七』に従う
+
+### 本文
+
+```
+推滅日　以有滅之朔経小餘, 減大衍通法。餘, 倍参伍乗之, 用減滅法。餘, 満朔虚分, 為日。不満, 為滅餘。命起経朔初日算外, 即合朔後滅日也。凡経朔小餘不満朔虚分者, 為有滅之朔。
+```
+p.2056
+
+```
+大衍通法:三千四十。
+四象之策:二十九:餘, 一千六百一十三。
+```
+p.2055-2056
+
+### 定数
+計算方法は宣明暦と変わらない。定数のみ取りだす
+
+#### 朔虚分
+
+本文中に言及はないが、宣明暦と変わらないと見て良い
+
+`理想の月日数` (30) * `大衍通法` (3040) - ( `四象之策` (29 * 3040 + 1613) ) = 1427
+
+#### 小余倍率
+
+`倍参伍` (2 * 3 * 5) = 30

data/doc/version/daien.md

@@ -0,0 +1,163 @@
+# 大衍暦
+
+天平宝字8年1月1日（764/02/07）- 貞観3年12月30日（862/02/02）
+
+# 著者
+
+[pldb](https://github.com/pldb)
+
+# 前提
+
+大衍暦は太陰太陽暦である
+
+詳細は [太陰太陽暦](./section/lunisolar_calendar.md) に記載してある
+
+# 計算
+
+計算にあたって、暦共通の計算と、大衍暦固有の計算がある
+
+暦共通の計算は前処理/後処理として説明する
+
+その間に大衍暦固有の計算を説明することとする
+
+## 共通前処理
+
+詳細は [共通前処理](./section/common_pre_process.md) に記載してある
+
+## 大衍暦固有の計算
+
+計算手順を以下に示す
+
+1. 11月定朔（補正後の月初日）を求める
+    1. 対象の西暦年から前年冬至を求める
+    2. 対象の西暦年から冬至の月齢を求める
+    3. 前年冬至から11月経朔（補正前の月初日）を求める
+    4. 二十四節気から太陽の運動の補正値を求める
+    5. 月の進退から月の運動の補正値を求める
+    6. 太陽・月の運動の補正値から11月定朔（補正後の月初日）を求める
+2. 12月定朔（補正後の月初日）を求める
+    1. 11月経朔を進めて12月経朔を求める
+    2. 11月の二十四節気を進めて12月の二十四節気を求める
+    3. 12月の二十四節気から太陽の運動の補正値を求める
+    4. 11月の月の進退を進めて12月の月の進退を求める
+    5. 12月の月の進退から月の運動の補正値を求める
+    6. 太陽・月の運動の補正値から12月定朔（補正後の月初日）を求める
+
+1の計算方法は『日本暦日原典』p.516-521に依拠する
+
+基本的に [宣明暦](./senmyou.md) と手順は変わらない
+
+使用する定数の差分は [定数](./section/const.md) に記載してある
+
+上記のうち、宣明暦との差分のみ記載する
+
+### 二十四節気から太陽の運動の補正値を求める
+
+「24気損益眺朒数」は次の通りである
+
+|-|a（眺朒数の初日の値）|b（損益率初日の値）|c（一日ごとの差）|
+|:----|:----|:----|:----|
+|冬至（とうじ）|0.0|+13.4524|-0.1886|
+|小寒（しょうかん）|+176.0|+10.5564|-0.1634|
+|大寒（だいかん）|+314.0|+8.0408|-0.1446|
+|立春（りっしゅん）|+418.0|+5.8160|-0.1318|
+|雨水（うすい）|+491.0|+3.7987|-0.1240|
+|啓蟄（けいちつ）|+535.0|+1.9265|-0.1240|
+|春分（しゅんぶん）|+551.0|-0.2048|-0.1178|
+|清明（せいめい）|+535.0|-1.9968|-0.1190|
+|穀雨（こくう）|+491.0|-3.7956|-0.1240|
+|立夏（りっか）|+418.0|-5.6626|-0.1324|
+|小満（しょうまん）|+314.0|-7.6555|-0.1436|
+|芒種（ぼうしゅ）|+176.0|-9.9405|-0.1436|
+|夏至（げし）|0.0|-12.0819|+0.1436|
+|小暑（しょうしょ）|-176.0|-9.7018|+0.1324|
+|大暑（たいしょ）|-314.0|-7.5450|+0.1240|
+|立秋（りっしゅう）|-418.0|-5.5634|+0.1190|
+|処暑（しょしょ）|-491.0|-3.7038|+0.1178|
+|白露（はくろ）|-535.0|-1.8954|+0.1178|
+|秋分（しゅうぶん）|-551.0|+0.1783|+0.1240|
+|寒露（かんろ）|-535.0|+2.0042|+0.1318|
+|霜降（そうこう）|-491.0|+3.8950|+0.1446|
+|立冬（りっとう）|-418.0|+5.9214|+0.1634|
+|小雪（しょうせつ）|-314.0|+8.1610|+0.1886|
+|大雪（たいせつ）|-176.0|+10.9010|+0.1886|
+
+#### 月の進退から月の運動の補正値を求める
+
+宣明暦とは異なり、次の表を用いる
+
+|入暦|小余（下限）|小余（上限）|増減率|遅速積|備考|
+|:----|:----|:----|:----|:----|:----|
+|01日|0|3040|+297|0|-|
+|02日|0|3040|+259|+297|-|
+|03日|0|3040|+220|+556|-|
+|04日|0|3040|+180|+776|-|
+|05日|0|3040|+139|+956|-|
+|06日|0|3040|+97|+1095|-|
+|07日|0|2701|+48|+1192|-|
+|07日|2701|3040|-6|+1240|+1192 + 48|
+|08日|0|3040|-64|+1234|-|
+|09日|0|3040|-106|+1170|-|
+|10日|0|3040|-148|+1064|-|
+|11日|0|3040|-189|+916|-|
+|12日|0|3040|-229|+727|-|
+|13日|0|3040|-267|+498|-|
+|14日|0|2363|-231|+231|-|
+|14日|2363|3040|-66|0|+232 - 231|
+|15日|0|3040|-289|-66|-|
+|16日|0|3040|-250|-355|-|
+|17日|0|3040|-211|-605|-|
+|18日|0|3040|-171|-816|-|
+|19日|0|3040|-130|-987|-|
+|20日|0|3040|-87|-1117|-|
+|21日|0|2024|-36|-1204|-|
+|21日|2024|3040|+18|-1240|-1204 - 36|
+|22日|0|3040|+73|-1222|-|
+|23日|0|3040|+116|-1149|-|
+|24日|0|3040|+157|-1033|-|
+|25日|0|3040|+198|-876|-|
+|26日|0|3040|+237|-678|-|
+|27日|0|3040|+276|-441|-|
+|28日|0|1686|+165|-165|-|
+
+『歴代天文律暦等志彙編　七』中華書房 p.2228-2230 により作成した
+
+宣明暦とは異なり進退の列がないが、それは無視して入暦だけを求めればよい
+
+これは『日本暦日原典』の中で計算方法Aとされている
+
+他の計算方法B,Cも掲載されているが、ここでは一旦割愛する
+
+#### 11月の二十四節気を進めて12月の二十四節気を求める
+
+「入気定日加減数」は次の通りである
+
+|二十四節気|経過|
+|:----|:----|
+| 冬至（とうじ）・大雪（たいせつ）|14 日 1351 分 7 秒|
+| 小寒（しょうかん）・小雪（しょうせつ）|14 日 1859 分 7 秒
+| 大寒（だいかん）・立冬（りっとう）|14 日 2314 分 7 秒|
+| 立春（りっしゅん）・霜降（そうこう）|14 日 2728 分 7 秒|
+| 雨水（うすい）・寒露（かんろ）|15 日 76 分 7 秒|
+| 啓蟄（けいちつ）・秋分（しゅうぶん）|15 日 450 分 7 秒|
+| 春分（しゅんぶん）・白露（はくろ）|15 日 878 分 7 秒|
+| 清明（せいめい）・処暑（しょしょ）|15 日 1252 分 7 秒|
+| 穀雨（こくう）・立秋（りっしゅう）|15 日 1640 分 7 秒|
+| 立夏（りっか）・大暑（たいしょ）|15 日 2054 分 7 秒|
+| 小満（しょうまん）・小暑（しょうしょ）|15 日 2509 分 7 秒|
+| 芒種（ぼうしゅ）・夏至（げし）|15 日 3017 分 7 秒|
+
+気策の 15-664.7 に対して、『歴代天文律暦等志彙編　七』中華書房 p.2224 盈縮分の行で加減している
+
+## 共通後処理
+
+詳細は [共通後処理](./section/common_post_process.md) に記載してある
+
+# 結語
+
+暦共通・大衍暦の暦算は以上である
+
+# 参考文献
+
+* 内田　正男『日本暦日原典』雄山閣出版 1975(1975)
+* 『歴代天文律暦等志彙編　七』中華書房

data/doc/version/genka.md

@@ -0,0 +1,116 @@
+# 元嘉暦
+
+允恭天皇34年1月1日（445/01/24）-文武天皇1年12月29日（698/02/15）
+
+# 著者
+
+[pldb](https://github.com/pldb)
+
+# 前提
+
+元嘉暦は太陰太陽暦である
+
+詳細は [太陰太陽暦](./section/lunisolar_calendar.md) に記載してある
+
+# 計算
+
+計算にあたって、暦共通の計算と、元嘉暦固有の計算がある
+
+暦共通の計算は前処理/後処理として説明する
+
+その間に元嘉暦固有の計算を説明することとする
+
+## 共通前処理
+
+詳細は [共通前処理](./section/common_pre_process.md) に記載してある
+
+## 元嘉暦固有の計算
+
+計算手順を以下に示す
+
+1. 正月朔を求める
+2. 正月中気を求める
+
+1の計算方法は『日本暦日原典』p.522-523に依拠する
+
+2の計算方法は『日本暦日原典』、『歴代天文律暦等志彙編　六』p.1728 に依拠する
+
+### 正月朔を求める
+
+前提として、 `西暦0年の積年` (1612) を使用する
+
+これは次の式により求められる
+
+`積年` (5703) - `元嘉20年` (443) - ( `紀法` (608) * `干支` (60) )
+
+次に、西暦x年の正月朔の大余小余を求める
+
+1. ( `西暦0年の積年` (1612) + x ) * `メトン周期（19年=235朔望月）` ( 235 / 19 ) = A ...余り
+
+2. A * `1年（紀日 / 紀法）` ( 22207 / 752 ) = B ...余りが朔の小余
+
+3. B / `大余上限` (60) = C ...余りが朔の大余
+
+『日本暦日原典』に挙げられている西暦529年の場合は次の通りとなる
+
+1. (1612 + 529) * 235 / 19 = 26480 ...15
+
+2. 26480 * 22207 / 752 = 781969 ...672
+
+3. 781969 / 60 = 13032 ...49
+
+これにより、大余49、小余 672 / `小余上限` (752) = 0.8936 が求められる
+
+### 正月中気を求める
+
+こちらは宋書（『歴代天文律暦等志彙編　六』）を参考にする
+
+西暦x年の正月中気の大余小余を求める
+
+1. ( `西暦0年の積年` (1612) + x) * `餘数 / 度法` (1595 / 304) = A' ...余りが中気の小余
+
+2. A' / 60 = B' ...余りが朔の大余
+
+西暦529年の場合は次の通りとなる
+
+1. (1612 + 529) * 1595 / 304 = 11233 ...63
+
+2. 11233 / 60 = 13033 ...13
+
+これにより、大余13、小余 126 / `度法` (304) = 0.2072 が求められる
+
+#### 計算方法の相違
+
+『日本暦日原典』の場合は次のようになる
+
+1. ( `西暦0年の積年` (1612) + x) * `紀日 / 紀法` (222070 / 608) = A' ...余りが中気の小余
+
+2. A' / 60 = B' ...余りが朔の大余
+
+『日本暦日原典』では分母を `紀法` にしているが、当ライブラリでは宋書にならって `度法` としたため採用しなかった
+
+両者は計算方法は異なるが、結果の大余小余は変わらない
+
+#### 餘数とは
+
+先述の `餘数` (1595) については注釈がないが、次のように求めることができた
+
+`紀日` (222070) = `紀法` (608) * 360 + 3190
+
+この 3190 が余りとなるが、分母が `紀法` (608) ではなく `度法` (304) のため2で割る
+
+これにより 3190 / 2 = 1595 となる
+
+## 共通後処理
+
+詳細は [共通後処理](./section/common_post_process.md) に記載してある
+
+# 結語
+
+暦共通・元嘉暦の暦算は以上である
+
+# 参考文献
+
+* 内田　正男『日本暦日原典』雄山閣出版 1975(1975)
+* 『歴代天文律暦等志彙編　六』中華書房
+

data/doc/version/gihou.md

@@ -0,0 +1,172 @@
+# 儀鳳暦
+
+文武天皇2年1月1日（698/02/16）-天平宝字7年12月30日（764/02/06）
+
+# 著者
+
+[pldb](https://github.com/pldb)
+
+# 前提
+
+儀鳳暦は太陰太陽暦である
+
+詳細は [太陰太陽暦](./section/lunisolar_calendar.md) に記載してある
+
+# 計算
+
+計算にあたって、暦共通の計算と、儀鳳暦固有の計算がある
+
+暦共通の計算は前処理/後処理として説明する
+
+その間に儀鳳暦固有の計算を説明することとする
+
+## 共通前処理
+
+詳細は [共通前処理](./section/common_pre_process.md) に記載してある
+
+## 儀鳳暦固有の計算
+
+計算手順を以下に示す
+
+1. 11月定朔（補正後の月初日）を求める
+    1. 対象の西暦年から前年冬至を求める
+    2. 対象の西暦年から冬至の月齢を求める
+    3. 前年冬至から11月経朔（補正前の月初日）を求める
+    4. 二十四節気から太陽の運動の補正値を求める
+    5. 月の進退から月の運動の補正値を求める
+    6. 太陽・月の運動の補正値から11月定朔（補正後の月初日）を求める
+2. 12月定朔（補正後の月初日）を求める
+    1. 11月経朔を進めて12月経朔を求める
+    2. 11月の二十四節気を進めて12月の二十四節気を求める
+    3. 12月の二十四節気から太陽の運動の補正値を求める
+    4. 11月の月の進退を進めて12月の月の進退を求める
+    5. 12月の月の進退から月の運動の補正値を求める
+    6. 太陽・月の運動の補正値から12月定朔（補正後の月初日）を求める
+
+1の計算方法は『日本暦日原典』p.516-520に依拠する
+
+基本的に [宣明暦](./senmyou.md) と手順は変わらない
+
+使用する定数の差分は [定数](./section/const.md) に記載してある
+
+上記のうち、宣明暦との差分のみ記載する
+
+### 二十四節気から太陽の運動の補正値を求める
+
+「24気損益眺朒数」は次の通りである
+
+|-|a（眺朒数の初日の値）|b（損益率初日の値）|c（一日ごとの差）|
+|:----|:----|:----|:----|
+|冬至（とうじ）|0.0|+3.9546|-0.0372|
+|小寒（しょうかん）|+54.0|+3.4091|-0.0372|
+|大寒（だいかん）|+100.0|+2.8636|-0.0372|
+|立春（りっしゅん）|+138.0|+2.3181|+0.0372|
+|雨水（うすい）|+176.0|+2.8636|+0.0372|
+|啓蟄（けいちつ）|+222.0|+3.4091|+0.0372|
+|春分（しゅんぶん）|+276.0|-3.7220|+0.0329|
+|清明（せいめい）|+222.0|-3.2086|+0.0329|
+|穀雨（こくう）|+176.0|-2.6952|+0.0329|
+|立夏（りっか）|+138.0|-2.1818|-0.0329|
+|小満（しょうまん）|+100.0|-2.6952|-0.0329|
+|芒種（ぼうしゅ）|+54.0|-3.2086|-0.0329|
+|夏至（げし）|0.0|-3.7220|+0.0329|
+|小暑（しょうしょ）|-54.0|-3.2086|+0.0329|
+|大暑（たいしょ）|-100.0|-2.6952|+0.0329|
+|立秋（りっしゅう）|-138.0|-2.1818|-0.0329|
+|処暑（しょしょ）|-176.0|-2.6952|-0.0329|
+|白露（はくろ）|-222.0|-3.2086|-0.0329|
+|秋分（しゅうぶん）|-276.0|+3.9546|-0.0372|
+|寒露（かんろ）|-222.0|+3.4091|-0.0372|
+|霜降（そうこう）|-176.0|+2.8636|-0.0372|
+|立冬（りっとう）|-138.0|+2.3181|+0.0372|
+|小雪（しょうせつ）|-100.0|+2.8636|+0.0372|
+|大雪（たいせつ）|-54.0|+3.4091|+0.0372|
+
+#### 月の進退から月の運動の補正値を求める
+
+宣明暦とは異なり、次の表を用いる
+
+|入暦|小余（下限）|小余（上限）|増減率|遅速積|備考|
+|:----|:----|:----|:----|:----|:----|
+|01日|0|1340|-134|0|-|
+|02日|0|1340|-117|-134|-|
+|03日|0|1340|-99|-251|-|
+|04日|0|1340|-78|-350|-|
+|05日|0|1340|-56|-428|-|
+|06日|0|1340|-33|-484|-|
+|07日|0|1191|-9|-517|-|
+|07日|1191|1340|0|-526|-|
+|08日|0|1340|+14|-526|-|
+|09日|0|1340|+38|-512|-|
+|10日|0|1340|+62|-474|-|
+|11日|0|1340|+85|-412|-|
+|12日|0|1340|+104|-327|-|
+|13日|0|1340|+121|-223|-|
+|14日|0|1042|+102|-102|-|
+|14日|1042|1340|+29|0|-|
+|15日|0|1340|+128|+29|-|
+|16日|0|1340|+115|+157|-|
+|17日|0|1340|+95|+272|-|
+|18日|0|1340|+74|+367|-|
+|19日|0|1340|+52|+441|-|
+|20日|0|1340|+28|+493|-|
+|21日|0|892|+4|+521|-|
+|21日|892|1340|0|+525|-|
+|22日|0|1340|-20|+525|-|
+|23日|0|1340|-44|+505|-|
+|24日|0|1340|-68|+461|-|
+|25日|0|1340|-89|+393|-|
+|26日|0|1340|-108|+304|-|
+|27日|0|1340|-125|+196|-|
+|28日|0|743.06|-71|+71|-|
+
+『歴代天文律暦等志彙編　七』中華書房 p.2010-2013 により作成した
+
+ただし、引用元を次のように訂正する
+
+* 14日の小余上限が 1402 となっているが、これは 1042 の誤り
+  * 宣明暦の定数と比較するとこの誤りが分かる
+    * 宣明暦の7日の小余は7465（初益）である。入暦は1始まりなので、0始まりで表現すると 6-7465 となる
+    * 6 * 8400（統法） + 7465（初益） = 57865
+    * 57865 * 2 = 115730
+    * 115730 / 1340（総法） = 13 余り 1041.690476
+    * 0始まりを1始まりにして少数部を丸めると 14-1042
+* 28日の小余上限が 743 となっているが、これを 743.06 とする
+  * 天平13年（741年） 2月 の計算により 743.06 とした
+
+宣明暦とは異なり進退の列がないが、それは無視して入暦だけを求めればよい
+
+これは『日本暦日原典』の中で計算方法Aとされている
+
+他の計算方法B,Cも掲載されているが、ここでは一旦割愛する
+
+#### 11月の二十四節気を進めて12月の二十四節気を求める
+
+「入気定日加減数」は次の通りである
+
+|二十四節気|経過|
+|:----|:----|
+| 冬至（とうじ）・大雪（たいせつ） | 14 日 910 分 5 秒 |
+| 小寒（しょうかん）・小雪（しょうせつ） | 14 日 1014 分 5 秒 |
+| 大寒（だいかん）・立冬（りっとう） | 14 日 1118 分 5 秒 |
+| 立春（りっしゅん）・霜降（そうこう） | 14 日 1118 分 5 秒 |
+| 雨水（うすい）・寒露（かんろ） | 14 日 1014 分 5 秒 |
+| 啓蟄（けいちつ）・秋分（しゅうぶん） | 14 日 910 分 5 秒 |
+| 春分（しゅんぶん）・白露（はくろ） | 15 日 1014 分 5 秒 |
+| 清明（せいめい）・処暑（しょしょ） | 15 日 910 分 5 秒 |
+| 穀雨（こくう）・立秋（りっしゅう） | 15 日 806 分 5 秒 |
+| 立夏（りっか）・大暑（たいしょ） | 15 日 806 分 5 秒 |
+| 小満（しょうまん）・小暑（しょうしょ） | 15 日 910 分 5 秒 |
+| 芒種（ぼうしゅ）・夏至（げし） | 15 日 1014 分 5 秒 |
+
+## 共通後処理
+
+詳細は [共通後処理](./section/common_post_process.md) に記載してある
+
+# 結語
+
+暦共通・儀鳳暦の暦算は以上である
+
+# 参考文献
+
+* 内田　正男『日本暦日原典』雄山閣出版 1975(1975)