zakuro 0.1.1 → 0.2.0

data/lib/zakuro/calculation/range/operated_range.rb

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

data/lib/zakuro/calculation/range/operated_solar_terms.rb

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

data/lib/zakuro/calculation/range/transfer/western_date_allocation.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      # :nodoc:
+      module Transfer
+        #
+        # WesternDateAllocation 西暦日の割り当て
+        #
+        module WesternDateAllocation
+          #
+          # 月初日の西暦日を更新する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Array<Year>] years 完全範囲（月初日なし）
+          #
+          # @return [Array<Year>] 完全範囲（月初日あり）
+          #
+          def self.get(context:, years:)
+            update_first_day(context: context, years: years)
+
+            years
+          end
+
+          #
+          # 月初日の西暦日を更新する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Array<Year>] years 完全範囲（月初日なし）
+          #
+          def self.update_first_day(context:, years:)
+            years.each_with_index do |year, index|
+              new_year_date = year.new_year_date.clone
+
+              months = year.months
+              update_first_day_within_all_months(
+                context: context,
+                new_year_date: new_year_date, months: months
+              )
+
+              years[index] = Base::Year.new(
+                multi_gengou: year.multi_gengou, new_year_date: new_year_date,
+                months: months, total_days: year.total_days
+              )
+            end
+          end
+
+          #
+          # 全ての月で月初日の西暦日を更新する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Western::Calendar] new_year_date 元旦
+          # @param [Array<Month>] months 月データ
+          #
+          def self.update_first_day_within_all_months(context:,
+                                                      new_year_date:, months:)
+            date = new_year_date.clone
+            months.each_with_index do |month, index|
+              updated_month = Monthly::Month.new(
+                context: context,
+                month_label: month.month_label,
+                first_day: Monthly::FirstDay.new(
+                  remainder: month.first_day.remainder,
+                  western_date: date
+                ),
+                solar_terms: month.solar_terms
+              )
+              months[index] = updated_month
+
+              date = date.clone + updated_month.days
+            end
+          end
+          private_class_method :update_first_day_within_all_months
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/range/transfer/year_boundary.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require_relative '../../../calculation/base/multi_gengou_roller'
+require_relative '../../../calculation/base/year'
+
+require_relative '../../../era/western'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      # :nodoc:
+      module Transfer
+        #
+        # YearBoundary 年境界
+        #
+        module YearBoundary
+          #
+          # 年間範囲内の年データの開始月を変更する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Array<Year>] annual_ranges 年データ（冬至基準）
+          #
+          # @return [Array<Year>] 年データ（元旦基準）
+          #
+          def self.get(context:, annual_ranges:)
+            categorize(context: context, annual_ranges: annual_ranges)
+            rearranged_years(annual_ranges: annual_ranges)
+          end
+
+          #
+          # 年間範囲内の年データの開始月を変更する
+          #
+          # @param [Array<Year>] annual_ranges 年データ（冬至基準）
+          #
+          # @return [Array<Year>] 年データ（元旦基準）
+          #
+          def self.rearranged_years(annual_ranges:)
+            years = []
+
+            (0..(annual_ranges.size - 2)).each do |index|
+              year = rearranged_year(annual_ranges: annual_ranges, index: index)
+              years.push(year)
+            end
+
+            years
+          end
+          private_class_method :rearranged_years
+
+          #
+          # 年間範囲を昨年/今年で分類する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Array<Year>] annual_range 1年データ
+          #
+          def self.categorize(context:, annual_ranges:)
+            annual_ranges.each do |annual_range|
+              categorize_year(context: context, annual_range: annual_range)
+            end
+          end
+          private_class_method :categorize
+
+          #
+          # 各月を昨年/今年で分類する
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Array<Month>] annual_range 1年データ
+          #
+          def self.categorize_year(context:, annual_range:)
+            is_last_year = true
+            annual_range.each_with_index do |month, index|
+              is_last_year = false if month.number == 1
+
+              annual_range[index] = Monthly::InitializedMonth.new(
+                context: context,
+                month_label: month.month_label, first_day: month.first_day,
+                solar_terms: month.solar_terms, phase_index: month.phase_index,
+                is_last_year: is_last_year
+              )
+            end
+          end
+          private_class_method :categorize_year
+
+          #
+          # 年データの開始月を変更する
+          #
+          # @param [Array<Year>] annual_ranges 年データ（冬至基準）
+          # @param [Integer] index 対象年の要素番号
+          #
+          # @return [Year] 年データ（元旦基準）
+          #
+          def self.rearranged_year(annual_ranges:, index:)
+            current_annual_range = annual_ranges[index]
+            next_annual_range = annual_ranges[index + 1]
+
+            year = push_current_year(annual_range: current_annual_range)
+            push_last_year(annual_range: next_annual_range, year: year)
+
+            year
+          end
+          private_class_method :rearranged_year
+
+          #
+          # 当年データを生成する
+          #
+          # @param [Array<Year>] annual_ranges 年データ（冬至基準）
+          # @param [Year] year 対象年
+          #
+          # @return [Year] 当年月ありの対象年
+          #
+          def self.push_current_year(annual_range:, year: Base::Year.new)
+            annual_range.each do |month|
+              next if month.is_last_year
+
+              year.push(month: month)
+            end
+
+            year
+          end
+          private_class_method :push_current_year
+
+          #
+          # 昨年データを生成する
+          #
+          # @param [Array<Year>] annual_ranges 年データ（冬至基準）
+          # @param [Year] year 対象年
+          #
+          # @return [Year] 昨年月ありの対象年
+          #
+          def self.push_last_year(annual_range:, year: Base::Year.new)
+            annual_range.each do |month|
+              next unless month.is_last_year
+
+              year.push(month: month)
+            end
+
+            year
+          end
+          private_class_method :push_last_year
+        end
+      end
+    end
+  end
+end