zakuro 0.0.0 → 0.1.1

data/lib/zakuro/version/senmyou/range/operated_range.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require_relative './full_range'
+require_relative './operated_solar_terms'
+require_relative '../../../operation/operation'
+require_relative '../monthly/operated_month'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Senmyou
+    #
+    # OperatedRange 運用結果範囲
+    #
+    # 何らかの理由により、計算された暦とは異なる運用結果である場合、その結果に合わせて計算結果を上書きする
+    class OperatedRange
+      # @return [Array<Year>] 年データ（完全範囲）
+      attr_reader :years
+      # @return [OperatedSolarTerms] 運用時二十四節気
+      attr_reader :operated_solar_terms
+
+      #
+      # 初期化
+      #
+      # @param [Array<Year>] years 年データ（完全範囲）
+      #
+      def initialize(years: [])
+        @years = years
+        @operated_solar_terms = OperatedSolarTerms.new(years: @years)
+        @operated_solar_terms.create
+      end
+
+      #
+      # 運用結果範囲を取得する
+      #
+      # @return [Array<Year>] 運用結果範囲
+      #
+      def get
+        rewrite
+      end
+
+      #
+      # 運用結果に書き換える
+      #
+      # @return [Array<Year>] 運用結果範囲
+      #
+      def rewrite
+        operated_years = []
+
+        years.each do |year|
+          operated_year = OperatedRange.rewrite_year(
+            year: year, operated_solar_terms: @operated_solar_terms
+          )
+          operated_years.push(operated_year)
+        end
+
+        operated_years
+      end
+
+      #
+      # 年を書き換える
+      #
+      # @param [Year] year 年
+      # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
+      #
+      # @return [Year] 年
+      #
+      def self.rewrite_year(year:, operated_solar_terms:)
+        result = Year.new(multi_gengou: year.multi_gengou, new_year_date: year.new_year_date)
+        year.months.each do |month|
+          result.push(month: resolve_month(
+            month: month, operated_solar_terms: operated_solar_terms
+          ))
+        end
+
+        result.commit
+
+        result
+      end
+
+      #
+      # 履歴情報の有無に応じた月にする
+      #
+      # @param [Month] month 月
+      # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
+      #
+      # @return [Month] 月
+      #
+      def self.resolve_month(month:, operated_solar_terms:)
+        history = Operation.specify_history(western_date: month.western_date)
+
+        return month if history.invalid?
+
+        OperatedRange.rewrite_month(
+          month: month, history: history, operated_solar_terms: operated_solar_terms
+        )
+      end
+
+      #
+      # 月を運用結果に書き換える
+      #
+      # @param [Month] month 月
+      # @param [Operation::MonthHistory] history 変更履歴
+      # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
+      #
+      # @return [Month] 月（運用結果）
+      #
+      def self.rewrite_month(month:, history:, operated_solar_terms:)
+        return month unless month.western_date == history.western_date
+
+        operated_month = OperatedMonth.new(
+          month_label: month.month_label, first_day: month.first_day,
+          solar_terms: month.solar_terms, history: history,
+          operated_solar_terms: operated_solar_terms
+        )
+
+        operated_month.rewrite
+
+        Month.new(
+          month_label: operated_month.month_label, first_day: operated_month.first_day,
+          solar_terms: operated_month.solar_terms
+        )
+      end
+    end
+  end
+end

data/lib/zakuro/version/senmyou/range/operated_solar_terms.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+require_relative './full_range'
+require_relative '../../../operation/operation'
+require_relative '../monthly/month'
+
+# TODO: solar_termの中はsrc/destだが、yamlはcalc/actual。統一したい。
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Senmyou
+    #
+    # OperatedSolarTerm 運用時二十四節気
+    #
+    class OperatedSolarTerms
+      # @return [Array<Year>] 完全範囲（年データ）
+      attr_reader :years
+      # @return [Hash<String, SolarTerm>] 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      #
+      # * 移動元の二十四節気：無効な大余小余あり（削除対象）
+      # * 移動先の二十四節気：移動元からの二十四節気（追加対象）
+      #
+      attr_reader :directions
+
+      #
+      # 初期化
+      #
+      # @param [Array<Year>] years 完全範囲（年データ）
+      #
+      def initialize(years: [])
+        @years = years
+        @directions = {}
+      end
+
+      #
+      # データ生成する
+      #
+      # @return [<Type>] <description>
+      #
+      def create
+        @directions = create_directions
+      end
+
+      #
+      # 二十四節気を取得する
+      #
+      # @param [Western::Calendar] western_date 月初日の西暦日
+      #
+      # @return [True] 対象あり
+      # @return [False] 対象なし
+      # @return [SolarTerm] 二十四節気
+      #
+      def get(western_date: Western::Calendar.new)
+        solar_term = @directions.fetch(western_date.format, SolarTerm.new)
+
+        # 合致しない場合
+        return false, SolarTerm.new if solar_term.empty?
+
+        # 合致した上で、二十四節気が移動元（削除対象）の場合
+        # 合致した上で、二十四節気が移動先（追加対象）の場合
+        [true, solar_term]
+      end
+
+      #
+      # 二十四節気の移動元/移動先を生成する
+      #
+      # @return [Hash<String, SolarTerm>] 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      #
+      def create_directions
+        directions = {}
+
+        years.each do |year|
+          OperatedSolarTerms.create_directions_with_months(
+            directions: directions, months: year.months
+          )
+        end
+
+        directions
+      end
+
+      # :reek:TooManyStatements { max_statements: 6 }
+
+      #
+      # 年内の全ての月の移動方向を作成する
+      #
+      # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      # @param [Array<Month>] months 年内の全ての月
+      #
+      def self.create_directions_with_months(directions: {}, months: [])
+        months.each do |month|
+          history = Operation.specify_history(western_date: month.western_date)
+
+          next if history.invalid?
+
+          direction = history.diffs.solar_term
+
+          next if direction.invalid?
+
+          OperatedSolarTerms.create_directions_each_month(
+            directions: directions, direction: direction, month: month
+          )
+        end
+      end
+
+      #
+      # 月毎の移動方向を作成する
+      #
+      # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      # @param [Operation::SolarTerm::Diretion] 二十四節気（移動）
+      # @param [Month] 月
+      #
+      def self.create_directions_each_month(directions: {},
+                                            direction: Operation::SolarTerm::Diretion.new,
+                                            month: Month.new)
+
+        month.solar_terms.each do |solar_term|
+          OperatedSolarTerms.push_source(directions: directions, direction: direction,
+                                         solar_term: solar_term)
+        end
+        OperatedSolarTerms.push_destination(directions: directions,
+                                            destination: direction.destination)
+      end
+
+      #
+      # 移動先に有効な二十四節気（差し替える二十四節気）を指定する
+      #
+      # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
+      # @param [SolarTerm] solar_term 二十四節気（計算値）
+      #
+      def self.push_source(directions: {}, direction: Operation::SolarTerm::Direction.new,
+                           solar_term: SolarTerm.new)
+        source = direction.source
+
+        return if source.invalid?
+
+        return unless source.index == solar_term.index
+
+        # 移動先に移動元の二十四節気を指定する
+        directions[source.to.format] = OperatedSolarTerms.created_source(
+          direction: direction, solar_term: solar_term
+        )
+      end
+
+      #
+      # 移動先に有効な二十四節気（差し替える二十四節気）を生成する
+      #
+      # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
+      # @param [SolarTerm] solar_term 二十四節気（計算値）
+      #
+      # @return [SolarTerm] 二十四節気（運用値）
+      #
+      def self.created_source(direction: Operation::SolarTerm::Direction.new,
+                              solar_term: SolarTerm.new)
+        operated_solar_term = solar_term.clone
+
+        unless direction.invalid_days?
+          # 二十四節気の大余をずらす
+          operated_solar_term.remainder.add!(
+            Remainder.new(day: direction.days, minute: 0, second: 0)
+          )
+        end
+
+        operated_solar_term
+      end
+
+      #
+      # 移動元に無効な二十四節気（連番のみ指定）を指定する
+      #
+      # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+      # @param [Operation::SolarTerm::Destination] destination 二十四節気（移動先）
+      #
+      def self.push_destination(directions: {}, destination: Operation::SolarTerm::Destination.new)
+        return if destination.invalid?
+
+        directions[destination.from.format] = SolarTerm.new(index: destination.index)
+      end
+    end
+  end
+end

data/lib/zakuro/version/senmyou/senmyou.rb

@@ -3,7 +3,7 @@
 require 'date'
 require_relative '../abstract_version'
 require_relative '../../era/western'
-require_relative 'summary/gengou_data'
+require_relative 'summary/single'
 
 # :nodoc:
 module Zakuro
@@ -27,7 +27,7 @@ module Zakuro
       #
       def self.to_japan_date(western_date:)
         date = Western::Calendar.create(date: western_date)
-        GengouData.get_ancient_date(date: date)
+        Single.get(date: date)
       end
     end
   end

data/lib/zakuro/version/senmyou/specifier/single_day_specifier.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require_relative '../../../era/western'
+require_relative '../range/full_range'
+require_relative '../base/multi_gengou_roller'
+require_relative '../base/year'
+require_relative '../../../output/response'
+require_relative '../../../output/logger'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Senmyou
+    #
+    # SingleDaySpecifier 一日検索
+    #
+    module SingleDaySpecifier
+      # @return [Logger] ロガー
+      LOGGER = Logger.new(location: 'specifier')
+
+      #
+      # 取得する
+      #
+      # @param [Array<Year>] yeas 範囲
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Result::Data::SingleDay] 和暦日
+      #
+      def self.get(years: [], date: Western::Calendar.new)
+        year = specify_year(years: years, date: date)
+
+        year = transfer(year: year, date: date)
+
+        month = specify_month(year: year, date: date)
+        first_date = month.western_date
+
+        Response::SingleDay.save_single_day(
+          param: Response::SingleDay::Param.new(
+            year: year, month: month,
+            date: date, days: date - first_date
+          )
+        )
+      end
+
+      #
+      # 年を特定する
+      #
+      # @param [Array<Year>] years 範囲
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Year] 対象年
+      #
+      def self.specify_year(years:, date:)
+        years.reverse_each do |year|
+          return year if date >= year.new_year_date
+        end
+
+        raise ArgumentError, "invalid year range. date: #{date.format}"
+      end
+      private_class_method :specify_year
+
+      #
+      # 改元する
+      #
+      # @param [Year] year 年
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Year] 改元後の年
+      #
+      def self.transfer(year:, date:)
+        multi_gengou = MultiGengouRoller.transfer(multi_gengou: year.multi_gengou, date: date)
+        Year.new(multi_gengou: multi_gengou, new_year_date: year.new_year_date,
+                 months: year.months, total_days: year.total_days)
+      end
+      private_class_method :transfer
+
+      # :reek:TooManyStatements { max_statements: 7 }
+
+      #
+      # 月を特定する
+      #
+      # @param [Year] year 年
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Month] 対象月
+      #
+      def self.specify_month(year:, date:)
+        months = year.months
+
+        current_month = months[0]
+        months.each do |month|
+          return current_month if month.western_date > date
+
+          current_month = month
+        end
+
+        current_month
+      end
+      private_class_method :specify_month
+    end
+  end
+end

data/lib/zakuro/version/senmyou/stella/lunar_orbit.rb

@@ -193,7 +193,7 @@ module Zakuro
           { |key, _| key.match(/^#{prefix}_#{format('%<day>02d', day: day)}_.*/) }
 
         targets.each do |key, value|
-          # NOTE 境界値は上から順に引き当てた方を返す（7日の境界値7465は上のキーで返す）
+          # NOTE: 境界値は上から順に引き当てた方を返す（7日の境界値7465は上のキーで返す）
           matched, diff = \
             extract_data_from_moon_adjustment_key(key, minute)
           # 小余の下げ幅

data/lib/zakuro/version/senmyou/stella/solar_average.rb

@@ -17,11 +17,11 @@ module Zakuro
       # 冬至から数えた1年データの月ごとに二十四節気を割り当てる
       #
       # @param [Integer] western_year 西暦年
-      # @param [Array<Month>] annual_data 1年データ
+      # @param [Array<Month>] annual_range 1年データ
       #
       # @return [Array<Month>] 1年データ
       #
-      def self.set_solar_terms_into_annual_data(western_year:, annual_data:)
+      def self.set_solar_terms_into_annual_range(western_year:, annual_range:)
         # 天正冬至
         winter_solstice = WinterSolstice.calc(western_year: western_year)
 
@@ -30,17 +30,17 @@ module Zakuro
           winter_solstice: winter_solstice
         )
 
-        apply_solar_terms_from_last_winter_solstice(annual_data: annual_data,
+        apply_solar_terms_from_last_winter_solstice(annual_range: annual_range,
                                                     solar_terms: solar_terms)
 
         # 前後の二十四節気
         rest_solar_terms = \
           collect_solar_terms_before_and_after(solar_terms: solar_terms)
 
-        apply_solar_terms_before_and_after(annual_data: annual_data,
+        apply_solar_terms_before_and_after(annual_range: annual_range,
                                            rest_solar_terms: rest_solar_terms)
 
-        annual_data
+        annual_range
       end
 
       # :reek:TooManyStatements { max_statements: 6 }
@@ -69,30 +69,56 @@ module Zakuro
       #
       # 各月の二十四節気を設定する
       #
-      # @param [Array<Month>] annual_data 1年データ
+      # @param [Array<Month>] annual_range 1年データ
       # @param [Array<Remainder>] solar_terms 1年データ内の全二十四節気
       #
-      def self.apply_solar_terms_from_last_winter_solstice(annual_data:,
-                                                           solar_terms:)
-        c_idx = 0
-        st_idx = 0
-        while c_idx < annual_data.size && st_idx < solar_terms.size
-          current_month = annual_data[c_idx]
-          next_month = annual_data[c_idx + 1]
-          solar_term = solar_terms[st_idx]
-
-          if in_range_solar_term?(target: solar_term, min: current_month.remainder,
-                                  max: next_month.remainder)
-            set_solar_term(month: current_month,
-                           solar_term: solar_term, solar_term_index: st_idx)
-            st_idx += 1
+      def self.apply_solar_terms_from_last_winter_solstice(annual_range:, solar_terms:)
+        month_index = 0
+        solar_term_index = 0
+        month_size = annual_range.size
+
+        while month_index < month_size && solar_term_index < solar_terms.size
+          raise StandardError, "month is over. idx: #{month_index}" if month_index >= month_size
+
+          if set_solar_term_on_current_month(current_month: annual_range[month_index],
+                                             next_month: annual_range[month_index + 1],
+                                             solar_term: solar_terms[solar_term_index],
+                                             solar_term_index: solar_term_index)
+            solar_term_index += 1
             next
           end
-          c_idx += 1
+
+          month_index += 1
         end
       end
       private_class_method :apply_solar_terms_from_last_winter_solstice
 
+      #
+      # 当月に二十四節気を設定する
+      #
+      # @param [Remainder] current_month 当月
+      # @param [Month] next_month 次月
+      # @param [Month] solar_term 二十四節気
+      # @param [Integer] solar_term_index 二十四節気位置
+      #
+      # @return [True] 設定済
+      # @return [False] 未設定
+      #
+      def self.set_solar_term_on_current_month(current_month:,
+                                               next_month:, solar_term:, solar_term_index:)
+        if in_range_solar_term?(target: solar_term, min: current_month.remainder,
+                                max: next_month.remainder)
+          set_solar_term(month: current_month,
+                         solar_term: solar_term, solar_term_index: solar_term_index)
+          return true
+        end
+
+        # 一度も割り当てがない場合は設定済みとして次の二十四節気を進める
+        return true if current_month.empty_solar_term?
+
+        false
+      end
+
       #
       # 1年データ内の二十四節気の前後を収集する
       #
@@ -120,18 +146,18 @@ module Zakuro
       #
       # 1年データ前後の二十四節気を適用する
       #
-      # @param [Array<Month>] annual_data 1年データ
+      # @param [Array<Month>] annual_range 1年データ
       # @param [Hash<Integer, Hash<Symbol, Integer>>, Hash<Integer, Hash<Symbol, Remainder>>]
       #   rest_solar_terms 前後
       #
-      def self.apply_solar_terms_before_and_after(annual_data:, rest_solar_terms:)
+      def self.apply_solar_terms_before_and_after(annual_range:, rest_solar_terms:)
         rest_solar_terms.each do |key, value|
           index = value[:index]
           solar_term = value[:solar_term]
-          data = annual_data[index]
+          data = annual_range[index]
           next unless in_range_solar_term?(
             target: solar_term,
-            min: data.remainder, max: annual_data[index + 1].remainder
+            min: data.remainder, max: annual_range[index + 1].remainder
           )
 
           set_solar_term(month: data,
@@ -176,13 +202,9 @@ module Zakuro
       #
       def self.set_solar_term(month:, solar_term:, solar_term_index:)
         term = SolarTerm.new(remainder: solar_term, index: solar_term_index)
-        if solar_term_index.even?
-          # 中気
-          month.even_term = term
-        else
-          # 節気
-          month.odd_term = term
-        end
+
+        # 設定する
+        month.add_term(term: term)
 
         nil
       end