zakuro 0.9.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fffb0d3903b07bc1c5b884bb73bef8a11ff65f5cfdb4c7d2a58df1c2777da633
-  data.tar.gz: c4a5ede6b55e073ac1b82b11c4b19a56a7ae7a518391bcde2c86a94461c61928
+  metadata.gz: 9dff0990ea44fc948599f2db2f6f4492caff773c328daabc39331716a31a43d2
+  data.tar.gz: 41a7b9296620670afec817686125f54bed22ee9f0410b544976fd819db7f0dd4
 SHA512:
-  metadata.gz: d2084bedda00006b2724616daaa6088e9034dd6e878d0ef145801a5da1ffd6e22af953ea812b24efcc996593a3ec0e7c49c368b8105f2a9b5d44efe9a91ff573
-  data.tar.gz: b960ab267ecb7667817c780b86b01ec4aac15a0d9f6ebde3a64c01cfd94d0343a9a37550ad9f98ea55a566102bcd426971e0d7ae1864a0a4af807a9414d4a8fd
+  metadata.gz: fe25f45f51c09f32fa1030defd7f05e5fa7ef0dd154b89840891f2d3c10c0736a13d9e327288c39f61d8a32dc3a248cb67a50c2e29b7c94cd8b3f22bc7389be9
+  data.tar.gz: 1251d5ac296435da1fcdc17db8493188432141b17c4dc21cea8cde0436f4597bd610b97ccbcbd225fd6d1a522ff106e70d643e11ac4211e42969a56cf91dd59a

data/Gemfile

@@ -13,8 +13,8 @@ end
 
 group :development do
   gem 'debase'
-  gem 'reek'
-  gem 'rubocop-performance'
+  gem 'reek', '6.1.4'
+  gem 'rubocop', '1.52.1'
   gem 'ruby-debug-ide'
   gem 'solargraph'
   gem 'yard'

data/README.md

@@ -1,3 +1,5 @@
+![logo](images/logo-text.png)
+
 # Zakuro - 石榴
 zakuro は日本の暦を扱う暦算ライブラリです。
 
@@ -10,15 +12,43 @@ zakuro は日本の暦を扱う暦算ライブラリです。
 
 石榴はただ伝来しただけでなく、日本の地に根づいております。これを日本の暦になぞらえ、和名の「ざくろ」を冠することと致します。
 
-## 導入
+# 有用性
+
+下記3資料を用いた和暦日(没日・滅日あり)の特定を一度の検索で可能とします。
+
+1. 『日本暦日原典〔第四版〕』
+2. 『日本暦日便覧』第四章　没日と滅日
+3. 『日本史年表　第5版』
+
+上記資料を用いる場合は、西暦年月日から1、2の該当のページを引き当てます。
+
+ただし、元号年表記のため、正確な元号は3の元号年月日を参照する必要があります。
+
+本ライブラリはこの手順をスキップし、直接、暦算値つきの和暦日を結果とします。
+
+さらに、和暦日からの西暦日検索も併せて可能とします。
 
-### Ruby
+[日本の暦日データベース](https://eco.mtk.nao.ac.jp/cgi-bin/koyomi/caldb.cgi) に近しい機能を持ちますが、
 
-次の範囲で動作確認しております。
+暦算値や没日・滅日を併せて結果出力する点が異なります。
 
-`2.6.x - 3.0.x`
+# 導入
 
-### Gem
+## Ruby
+
+Rubyの推奨バージョンは次の範囲とします。
+
+`2.6.x - 3.3.x`
+
+当ライブラリのバージョンが `1.0.0` の時点では、下記バージョンで動作確認を実施しております。
+* 2.6.3
+* 2.7.6
+* 3.0.6
+* 3.1.4
+* 3.2.2
+* 3.3.0-preview1
+
+## Gem
 
 [rubygem](https://rubygems.org/gems/zakuro) に登録しております。
 
@@ -40,7 +70,7 @@ Or install it yourself as:
 
 1日検索/期間検索に対応しております。
 
-下記表で暦算ありの暦は使用可能です。
+バージョンが `1.0.0` の時点では、下記表で暦算ありの暦が使用可能です。
 
 |開始日|暦   |計算方法|暦算|没日|滅日|
 |:----|:----|:----|:---|:---|:---|
@@ -62,8 +92,6 @@ Or install it yourself as:
 
 現在は「長慶宣明暦算法」の計算手順Aのみ対応しております。
 
-「没日」「滅日」は計算できますが、正誤を確認中です。
-
 # 使用方法
 
 [使用方法](./doc/usage.md) を参照してください。
@@ -122,6 +150,11 @@ Or install it yourself as:
 
 https://github.com/pldb/zakuro
 
+## ロゴ・バナー
+
+* 制作: [migut.t](https://www.instagram.com/migut.t/#)
+* 調整: [pldb](https://github.com/pldb)
+
 
 ## ライセンス
 

data/VERSION

@@ -1 +1 @@
-0.9.4
+1.0.0

data/doc/gengou.md

@@ -106,7 +106,7 @@
 |治安|1|1021-2-15|1年2月2日|1021-3-17|1021-3-17| |
 |万寿|1|1024-2-13|1年7月13日|1024-8-19|1024-8-19| |
 |長元|1|1028-1-30|1年7月25日|1028-8-18|1028-8-18| |
-|長暦|1|1037-1-19|1年4月21日|1037-5-9|1037-5-9| |
+|長暦|1|1037-1-19|1年4月21日|1037-5-9|1037-5-9|行親記（計算：1037-5-8）|
 |長久|1|1040-2-15|1年11月10日|1040-12-16|1040-12-16| |
 |寛徳|1|1044-2-2|1年11月24日|1044-12-16|1044-12-16| |
 |永承|1|1046-2-9|1年4月14日|1046-5-22|1046-5-22| |

data/doc/operation/csv/month.csv

@@ -199,7 +199,7 @@
 ,139-3-1,-,-,139,3,823-11-6,弘仁 14年 10 大 壬午 17-2819,"計算は17辛巳であるが大嘗会御禊日例, 皇年代略記等により壬午朔, ユリウス暦日は11月7日。",-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,辛巳,壬午,823-11-6,823-11-7,17,18,1,1,-,-,-
 ,140-1-1,-,-,140,1,824-3-4,天長 1年 2 大 庚辰 16-2957,-,改変なし（内容転記せず）,false,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,140-2-1,-,-,140,2,825-5-21,天長 2年 5 大 癸卯 39-2877,-,改変なし（内容転記せず）,false,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
-,140-3-a,-,140-3-1,140,-,825-1-12,天長 2年 12 大 己亥 35-1289,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
+,140-3-a,-,140-3-1,140,-,826-1-12,天長 2年 12 大 己亥 35-1289,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,140-3-1,-,-,140,3,826-2-11,天長 3年 1 大 戊辰 5-250,紀略に正月戊辰朔と計算より1日退いている。したがってそのユリウス暦日は2月10日となる。,-,true,朔日相違,-,-,小,大,-,-,-,-,-,-,己巳,戊辰,826-2-11,826-2-10,5,4,-1,-1,-,-,-
 ,140-4-1,-,-,140,4,826-11-3,天長 3年 10 大 甲午 30-2847,-,改変なし（内容転記せず）,false,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,141-1-1,-,-,141,1,827-3-1,天長 4年 2 大 壬辰 28-2846,-,改変なし（内容転記せず）,false,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
@@ -238,7 +238,7 @@
 ,146-3-1,-,-,146,3,844-6-19,承和 11年 6 小 癸丑 48-2934,計算は48壬子，続後紀は癸丑朔，したがって6月朔日のユリウス暦日は6月20日。,-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,壬子,癸丑,844-6-19,844-6-20,48,49,1,1,-,-,-
 ,146-4-a,-,146-4-1,146,-,844-9-16,承和 11年 8 大 辛巳 17-1383,-,-,true,次月大小,-,-,小,大,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,146-4-1,-,-,146,4,844-10-15,承和 11年 9 小 辛亥 46-2695,計算は46庚戌，続後紀は辛亥朔，したがって9月朔日のユリウス暦日は10月16日。,-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,庚戌,辛亥,844-10-15,844-10-16,46,47,1,1,-,-,-
-,147-1-a,-,147-1-1,147,-,645-10-5,承和 12年 9 大 乙巳 41-1264,-,-,true,次月大小,-,-,小,大,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
+,147-1-a,-,147-1-1,147,-,845-10-5,承和 12年 9 大 乙巳 41-1264,-,-,true,次月大小,-,-,小,大,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,147-1-1,-,-,147,1,845-11-3,承和 12年 10 小 乙亥 10-2799,計算は10甲戌，続後紀は乙亥朔，したがって10月朔日のユリウス暦日は11月4日。,-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,甲戌,乙亥,845-11-3,845-11-4,10,11,1,1,-,-,-
 ,147-2-a,-,147-2-1,147,-,845-12-3,承和 12年 11 大 甲辰 40-1261,-,-,true,次月大小,-,-,小,大,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,147-2-1,-,-,147,2,846-1-1,承和 12年 12 小 甲戌 9-2726,計算は9癸酉，続後紀は甲戌朔，したがって12月朔日のユリウス暦日は1月2日。,-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,癸酉,甲戌,846-1-1,846-1-2,9,10,1,1,-,-,-
@@ -361,11 +361,11 @@
 ,226-1-a,-,226-1-1,226,-,1082-5-1,永保 2年 4 大 壬子 48-1071,-,-,true,次月大小,-,-,小,大,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,226-1-1,-,-,226,1,1082-5-30,永保 2年 5 小 壬午 17-5669,"計算と扶桑略記は辛巳, 為房卿記により壬午とする方がよいと思われる。5月壬午朔とすればユリウス暦日は5月31日となる。",-,true,朔日相違,-,-,大,小,-,-,-,-,-,-,辛巳,壬午,1082-5-30,1082-5-31,17,18,1,1,-,-,-
 ,228-1-a,-,228-1-1,228,-,1089-1-15,寛治 2年 12 小 癸卯 39-320,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
-,228-1-1,-,-,228,1,1089-2-14,寛治 3年 1 大 壬申 9-6402,"計算では9癸酉であるが, 四大を避けるため壬申朔となった。正月壬申朔のユリウス暦日は2月13日。（大日本史料第3編の1; 中右記・扶桑略記・後二条師通記）。",-,true,四大回避,-,-,大,大,-,-,-,-,-,-,癸酉,壬申,1089-2-14,1089-2-13,9,8,-1,-1,-,-,-
+,228-1-1,-,-,228,1,1089-2-14,寛治 3年 1 大 壬申 9-6402,"計算では9癸酉であるが, 四大を避けるため壬申朔となった。正月壬申朔のユリウス暦日は2月13日。（大日本史料第3編の1; 中右記・扶桑略記・後二条師通記）。",-,true,四大回避,-,-,小,大,-,-,-,-,-,-,癸酉,壬申,1089-2-14,1089-2-13,9,8,-1,-1,-,-,-
 ,230-1-a,-,230-1-1,230,-,1095-1-9,嘉保 1年 12 小 戊辰  4-3361,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,230-1-1,-,-,230,1,1095-2-8,嘉保 2年 1 大 丁酉 34-7200,"計算では34戊戌であるが, 中右記により丁酉朔, 正月丁酉朔のユリウス暦日は2月7日。これは嘉保元年の年間日数が385日になるのを避けるための変更である。",-,true,年日数,-,-,小,大,-,-,-,-,-,-,戊戌,丁酉,1095-2-8,1095-2-7,34,33,-1,-1,-,-,-
 ,242-1-a,-,242-1-1,242,-,1129-8-17,大治 4年 閏7 小 丁未 43-1179,-,-,true,次月大小,8月,閏7月,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
-,242-1-1,-,-,242,1,1129-9-16,大治 4年 8 大 丙子 13-6547,"計算は13丁丑であるが中右記により丙子, 8月丙子朔のユリウス暦日は9月15日となる。これは皇和通暦で中根元圭が「章首の後, 閏法もし8月を得ればまた必ず大小を消息してこれを7月に退く」と書いてあるように, このあとも何回かこの理由で干支が変更され, 閏が8月から7月に移された。これを退閏という。",-,true,退閏,閏8月,8月,大,大,-,-,-,-,-,-,丁丑,丙子,1129-9-16,1129-9-15,13,12,-1,-1,-,-,-
+,242-1-1,-,-,242,1,1129-9-16,大治 4年 8 大 丙子 13-6547,"計算は13丁丑であるが中右記により丙子, 8月丙子朔のユリウス暦日は9月15日となる。これは皇和通暦で中根元圭が「章首の後, 閏法もし8月を得ればまた必ず大小を消息してこれを7月に退く」と書いてあるように, このあとも何回かこの理由で干支が変更され, 閏が8月から7月に移された。これを退閏という。",-,true,退閏,閏8月,8月,小,大,-,-,-,-,-,-,丁丑,丙子,1129-9-16,1129-9-15,13,12,-1,-1,-,-,-
 ,245-1-a,-,245-1-1,245,-,1138-1-13,保延 3年 12 小 戊午 54-2825,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,245-1-1,-,-,245,1,1138-2-12,保延 4年 1 大 丁亥 24-6432,"計算では24戊子であるが中右記により丁亥, 正月丁亥朔のユリウス暦日は2月11日となる。保延3年の年間日数の385日になるのを避けるためである。",-,true,年日数,-,-,小,大,-,-,-,-,-,-,戊子,丁亥,1138-2-12,1138-2-11,24,23,-1,-1,-,-,-
 ,251-1-a,-,251-1-1,251,-,1156-11-15,保元 1年 10 小 己亥 35-1816,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
@@ -389,7 +389,7 @@
 ,272-1-a,-,272-1-1,272,-,1221-11-16,承久 3年 閏10 小 辛巳 17-1577,-,-,true,次月大小,11月,閏10月,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,272-1-1,-,-,272,1,1221-12-16,承久 3年 11 大 庚戌 47-8177,"計算では47辛亥, 朔旦冬至にするため庚戌朔, そのユリウス暦日は12月15日になる。",-,true,朔旦冬至,閏11月,11月,大,大,-,-,-,-,-,-,辛亥,庚戌,1221-12-16,1221-12-15,47,46,-1,-1,-,-,-
 ,272-2-1,-,-,272,2,1222-1-15,承久 3年 12 大 庚辰 17-6684,"計算では17辛巳, 1)の変更のためここは庚辰にしないと11月が31日になってしまう。したがって12月朔のユリウス暦日は1月14日となる。（大日本史料第5編の1; 承久3年, 4年日次記, 吾妻鏡）",-,true,朔旦冬至,-,-,小,大,-,-,-,-,-,-,辛巳,庚辰,1222-1-15,1222-1-14,17,16,-1,-1,-,-,-
-,275-1-a,-,275-1-1,275,-,1228-1-8,安貞 1年 12 小 丙午 42-2281,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
+,275-1-a,-,275-1-1,275,-,1228-1-9,安貞 1年 12 小 丙午 42-2281,-,-,true,次月大小,-,-,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,275-1-1,-,-,275,1,1228-2-8,安貞 2年 1 大 乙亥 12-6333,"計算では12丙子, 大日本史料第5編の1, 玉蘂ほか, 吾妻鏡などにより乙亥, 正月乙亥朔のユリウス暦日は2月7日となる。安貞元年の年間日数が385日になるのを避けるため。",-,true,年日数,-,-,小,大,-,-,-,-,-,-,丙子,乙亥,1228-2-8,1228-2-7,12,11,-1,-1,-,-,-
 ,280-1-a,-,280-1-1,280,-,1243-8-17,寛元 1年 閏7 小 乙巳 41-3888,-,-,true,次月大小,8月,閏7月,大,小,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-,-
 ,280-1-1,-,-,280,1,1243-9-16,寛元 1年 8 大 甲戌 11-8386,"計算では11乙亥, 妙光寺内府除目部類・吾妻鏡など（大日本史料第5編の16）により甲戌, 8月甲戌朔のユリウス暦日は9月15日。章首の後の閏8月を避けるためである。大治4（1129）年の注参照。",-,true,閏8月回避,閏8月,8月,小,大,-,-,-,-,-,-,乙亥,甲戌,1243-9-16,1243-9-15,11,10,-1,-1,-,-,-

data/lib/zakuro/calculation/base/gengou.rb

@@ -78,9 +78,7 @@ module Zakuro
           result = match_first_line_by_name(name: name)
           return result unless result.invalid?
 
-          result = match_second_line_by_name(name: name)
-
-          result
+          match_second_line_by_name(name: name)
         end
 
         #
@@ -120,7 +118,7 @@ module Zakuro
         # @return [False] 不正なし
         #
         def invalid?
-          first_line.size.zero? && second_line.size.zero?
+          first_line.empty? && second_line.empty?
         end
       end
     end

data/lib/zakuro/calculation/base/year.rb

@@ -70,7 +70,7 @@ module Zakuro
         def new_year_date
           return Western::Calendar.new unless months
 
-          return Western::Calendar.new if months.size.zero?
+          return Western::Calendar.new if months.empty?
 
           months[0].western_date
         end

data/lib/zakuro/calculation/era/gengou/abstract_scroll.rb

@@ -179,9 +179,9 @@ module Zakuro
         # @return [Array<Counter>] 差し替え結果
         #
         def replace_gengou(source: [], destination: [])
-          return destination if destination.size.zero?
+          return destination if destination.empty?
 
-          return destination if source.size.zero?
+          return destination if source.empty?
 
           last = source[-1]
           destination[0] = last if destination[0].name == last.name

data/lib/zakuro/calculation/era/gengou/internal/publisher.rb

@@ -54,7 +54,7 @@ module Zakuro
           # @return [Array<Base::LinearGengou>] 元号リスト
           #
           def to_linear_gengou(start_date:, last_date:, gengou_list: [])
-            return [] if gengou_list.size.zero?
+            return [] if gengou_list.empty?
 
             result = []
 

data/lib/zakuro/calculation/era/gengou/internal/reserve/abstract_list.rb

@@ -160,7 +160,7 @@ module Zakuro
           def western_last_year
             return INVALID_YEAR if invalid?
 
-            return INVALID_YEAR if list.size.zero?
+            return INVALID_YEAR if list.empty?
 
             list[-1].gengou.last_year
           end
@@ -174,7 +174,7 @@ module Zakuro
           def invalid?
             return true unless list
 
-            return true if list.size.zero?
+            return true if list.empty?
 
             false
           end
@@ -185,7 +185,7 @@ module Zakuro
           # @return [Western::Calendar]設定された元号の開始日
           #
           def native_start_date
-            return Western::Calendar.new if list.size.zero?
+            return Western::Calendar.new if list.empty?
 
             list[0].native_start_date
           end
@@ -197,7 +197,7 @@ module Zakuro
           # @return [False] 同一
           #
           def change_start_date?
-            return false if list.size.zero?
+            return false if list.empty?
 
             list[0].change_start_date?
           end

data/lib/zakuro/calculation/era/gengou/internal/reserve/empty_link.rb

@@ -33,7 +33,7 @@ module Zakuro
             #
             def fill(counters:, start_date: Western::Calendar.new,
                      last_date: Western::Calendar.new)
-              if counters.size.zero?
+              if counters.empty?
                 counters.push(
                   create_empty_counter(
                     start_date: start_date.clone,
@@ -104,7 +104,7 @@ module Zakuro
             # @param [Array<Gengou::Counter>] counters 加算元号リスト
             #
             def fill_middle(counters:)
-              return if counters.size.zero?
+              return if counters.empty?
 
               size = counters.size - 1
               (0..size).reverse_each do |index|
@@ -144,7 +144,7 @@ module Zakuro
             #
             def create_empty_counter(start_date:, last_date:)
               Gengou::Counter.new(
-                gengou: Japan::Gengou::Resource::Gengou.new,
+                gengou: Japan::Type::Base::Gengou.new,
                 start_date: start_date, last_date: last_date
               )
             end

data/lib/zakuro/calculation/era/gengou/internal/reserve/named_list.rb

@@ -60,7 +60,7 @@ module Zakuro
             [start, last].each do |name|
               gengou_list = line_by_name(name: name)
 
-              next if gengou_list.size.zero?
+              next if gengou_list.empty?
 
               choise_start_date(
                 date: gengou_list[0].start_date.clone

data/lib/zakuro/calculation/era/version/internal/crawler.rb

@@ -50,14 +50,14 @@ module Zakuro
           # @return [Range] 範囲
           #
           def narrow(range:, start_year:, last_year:)
-            range_start_year = range.start_year
-            range_start_year = start_year if start_year > range.start_year
+            range_start_year = range.start_year.western
+            range_start_year = start_year if start_year > range.start_year.western
 
             range_last_year = range.last_year
             range_last_year = last_year if last_year < range.last_year
 
             Range.new(
-              name: range.name, start_date: range.start_date.clone,
+              name: range.name, start_date: range.start_date.western.clone,
               start_year: range_start_year, last_year: range_last_year
             )
           end

data/lib/zakuro/calculation/monthly/abstract_lunar_phase.rb

@@ -2,7 +2,7 @@
 
 require_relative '../../output/logger'
 
-require_relative './const'
+require_relative './internal/part/const'
 
 # :nodoc:
 module Zakuro

data/lib/zakuro/calculation/monthly/internal/date_comparer.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Monthly
+      #
+      # DateComparer 日付比較
+      #
+      module DateComparer
+        class << self
+          #
+          # 範囲内か
+          #
+          # @param [Western::Calendar] date 日付
+          # @param [Western::Calendar] start_date 開始日
+          # @param [Western::Calendar] last_date 終了日
+          #
+          # @return [True] 範囲内
+          # @return [False] 範囲外
+          #
+          def include?(date:, start_date:, last_date:)
+            return false if start_date.invalid?
+
+            return false if date < start_date
+
+            return false if date > last_date
+
+            true
+          end
+
+          #
+          # 範囲内か
+          #
+          # @param [Japan::Calendar] date 日付
+          # @param [Base::Gengou] gengou 元号
+          # @param [MonthLabel] month_label 月表示名
+          #
+          # @return [True] 範囲内
+          # @return [False] 範囲外
+          #
+          def include_by_japan_date?(date:, gengou:, month_label:)
+            linear_gengou = gengou.match_by_name(name: date.gengou)
+
+            return false if linear_gengou.invalid?
+
+            return false unless linear_gengou.name == date.gengou
+
+            return false unless linear_gengou.year == date.year
+
+            same_by_japan_date?(month_label: month_label, date: date)
+          end
+
+          private
+
+          #
+          # 同一の月情報かを検証する
+          #
+          # @param [MonthLabel] month_label 月表示名
+          # @param [Japan::Calendar] date 日付
+          #
+          # @return [True] 同一の月
+          # @return [False] 異なる月
+          #
+          def same_by_japan_date?(month_label:, date: Japan::Calendar.new)
+            return false unless month_label.number == date.month
+
+            return false unless month_label.leaped == date.leaped
+
+            true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/monthly/{meta → internal/meta}/all_solar_term.rb

@@ -48,7 +48,7 @@ module Zakuro
 
             first = all_solar_terms[0].clone
 
-            return all_solar_terms if before_solar_terms.size.zero?
+            return all_solar_terms if before_solar_terms.empty?
 
             # 最初の二十四節気が月初日と同日であれば何もしない
             return all_solar_terms if first.remainder.day == remainder.day

data/lib/zakuro/calculation/monthly/{meta → internal/meta}/meta_collector.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative '../../../era/western/calendar'
+require_relative '../../../../era/western/calendar'
 
-require_relative '../month'
+require_relative '../../month'
 
 require_relative './all_solar_term'
 

data/lib/zakuro/calculation/monthly/{first_day.rb → internal/part/first_day.rb}

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative '../../era/western/calendar'
+require_relative '../../../../era/western/calendar'
 
-require_relative '../cycle/abstract_remainder'
+require_relative '../../../cycle/abstract_remainder'
 
 # :nodoc:
 module Zakuro

data/lib/zakuro/calculation/monthly/{meta.rb → internal/part/meta.rb}

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../cycle/abstract_remainder'
+require_relative '../../../cycle/abstract_remainder'
 
 # :nodoc:
 module Zakuro

data/lib/zakuro/calculation/monthly/internal/solar_term_selector.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require_relative '../../cycle/abstract_solar_term'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Monthly
+      #
+      # SolarTermSelector 二十四節気検索
+      #
+      class SolarTermSelector
+        # @return [Integer] 月最後の二十四節気を検索する大余の範囲上限
+        LAST_DAY_LIMIT = 20
+
+        # @return [Context::Context] 暦コンテキスト
+        attr_reader :context
+        # @return [Array<Cyle::AbstractSolarTerm>] 二十四節気
+        attr_reader :solar_terms
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Array<Cyle::AbstractSolarTerm>] solar_terms 二十四節気
+        #
+        def initialize(context: Context::Context.new, solar_terms: [])
+          @context = context
+          @solar_terms = solar_terms
+        end
+
+        #
+        # 二十四節気が未設定かどうかを検証する
+        #
+        # @return [True] 設定なし
+        # @return [False] 設定あり
+        #
+        def empty?
+          solar_terms.empty?
+        end
+
+        #
+        # 中気を返す
+        #
+        # @return [Cycle::AbstractSolarTerm] 中気
+        #
+        def even_term
+          solar_terms.each do |term|
+            return term if term.index.even?
+          end
+
+          context.resolver.solar_term.new
+        end
+
+        #
+        # 節気を返す
+        #
+        # @return [Cycle::AbstractSolarTerm] 節気
+        #
+        def odd_term
+          solar_terms.each do |term|
+            return term if term.index.odd?
+          end
+
+          context.resolver.solar_term.new
+        end
+
+        #
+        # 二十四節気を追加する
+        #
+        # @param [Cycle::AbstractSolarTerm] term 二十四節気
+        #
+        def add_term(term:)
+          solar_terms.push(term)
+        end
+
+        #
+        # 二十四節気を正しい順序にソートする
+        #
+        def sort
+          sorted = (solar_terms.sort do |termx, termy|
+            termx.index <=> termy.index
+          end)
+
+          unless reset_term?(solar_terms: sorted)
+            @solar_terms = sorted
+            return
+          end
+
+          @solar_terms = reset(terms: sorted)
+        end
+
+        #
+        # 大余に対応する二十四節気
+        #
+        # @param [Integer] day 大余
+        #
+        # @return [Cycle::AbstractSolarTerm] 二十四節気
+        #
+
+        #
+        # 大余に対応する二十四節気
+        #
+        # @param [Integer] day 大余
+        # @param [Meta] meta メタ情報
+        #
+        # @return [Cycle::AbstractSolarTerm] 二十四節気
+        #
+        def solar_term_by_day(day:, meta:)
+          target = context.resolver.remainder.new(day: day, minute: 0, second: 0)
+
+          meta.all_solar_terms.each_cons(2) do |current_solar_term, next_solar_term|
+            in_range = Tool::RemainderComparer.in_range?(
+              target: target, start: current_solar_term.remainder, last: next_solar_term.remainder
+            )
+            return current_solar_term if in_range
+          end
+
+          last_solar_term(target: target, meta: meta)
+        end
+
+        private
+
+        #
+        # 二十四節気の折り返し（23 -> 0）があるか
+        #
+        # @param [Array<Cyle::AbstractSolarTerm>] solar_terms 二十四節気
+        #
+        # @return [True] 折り返しあり
+        # @return [False] 折り返しなし
+        #
+        def reset_term?(solar_terms: [])
+          first = false
+          last = false
+
+          solar_terms.each do |term|
+            index = term.index
+            case index
+            when Cycle::AbstractSolarTerm::FIRST_INDEX
+              first = true
+            when Cycle::AbstractSolarTerm::LAST_INDEX
+              last = true
+            end
+          end
+
+          first && last
+        end
+
+        #
+        # 二十四節気を終端で折り返す
+        #
+        # @param [Array<Cyle::AbstractSolarTerm>] terms 二十四節気
+        #
+        # @return [Array<Cyle::AbstractSolarTerm>] 折り返し済みの二十四節気
+        #
+        def reset(terms: [])
+          first = []
+          second = []
+
+          terms.each do |term|
+            # NOTE: 二十四節気は最大3つとすると、 「23, 0」「22, 23, 0」「23, 0, 1」 での折り返しが考えられる
+            if term.index >= (Cycle::AbstractSolarTerm::LAST_INDEX - 2)
+              second.push(term)
+              next
+            end
+
+            first.push(term)
+          end
+
+          # 0以前を先頭にする
+          second += first
+
+          second
+        end
+
+        #
+        # 最後の二十四節気を返す
+        #
+        # @param [Cycle::AbstractRemainder] target 対象の大余情報
+        # @param [Meta] meta メタ情報
+        #
+        # @return [Cycle::AbstractSolarTerm] 二十四節気
+        #
+        def last_solar_term(target:, meta:)
+          last = meta.all_solar_terms[-1]
+
+          empty_solar_term = context.resolver.solar_term.new
+
+          return empty_solar_term unless last
+
+          if Tool::RemainderComparer.in_limit?(target: target, start: last.remainder,
+                                               limit: LAST_DAY_LIMIT)
+            return last
+          end
+
+          empty_solar_term
+        end
+      end
+    end
+  end
+end