zakuro 0.6.1 → 0.8.0

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

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
-require_relative './month'
 require_relative '../../operation/operation'
+require_relative './operated_solar_term'
+require_relative './month'
 
 # :nodoc:
 module Zakuro
@@ -17,8 +18,8 @@ module Zakuro
       class OperatedMonth < Month
         # @return [Operation::MonthHistory] 変更履歴（月）
         attr_reader :history
-        # @return [OperatedSolarTerms] 運用時二十四節気
-        attr_reader :operated_solar_terms
+        # @return [OperatedSolarTerm] 運用時二十四節気
+        attr_reader :operated_solar_term
 
         # :reek:LongParameterList {max_params: 6}
         # rubocop:disable Metrics/ParameterLists
@@ -26,20 +27,20 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
-        # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [OperatedSolarTerm] operated_solar_term 運用時二十四節気
         # @param [MonthLabel] month_label 月表示名
         # @param [FirstDay] first_day 月初日（朔日）
         # @param [Array<SolarTerm>] solar_terms 二十四節気
         # @param [Operation::MonthHistory] history 変更履歴（月）
         #
-        def initialize(context:, operated_solar_terms:, month_label: MonthLabel.new,
+        def initialize(context:, operated_solar_term:, month_label: MonthLabel.new,
                        first_day: FirstDay.new, solar_terms: [], gengou: Base::Gengou.new,
                        history: Operation::MonthHistory.new)
           super(context: context, month_label: month_label, first_day: first_day,
                 solar_terms: solar_terms, gengou: gengou)
           @history = history
-          @operated_solar_terms = operated_solar_terms
+          @operated_solar_term = operated_solar_term
           @moved = false
         end
 
@@ -61,110 +62,39 @@ module Zakuro
           diff = history.diffs.month
 
           @month_label = MonthLabel.new(
-            number: OperatedMonth.rewrite_month_fields(
+            number: self.class.rewrite_month_fields(
               month_diff: diff, month_label: month_label, name: 'number'
             ),
-            is_many_days: OperatedMonth.rewrite_month_fields(
+            is_many_days: self.class.rewrite_month_fields(
               month_diff: diff, month_label: month_label, name: 'is_many_days'
             ),
-            leaped: OperatedMonth.rewrite_month_fields(
+            leaped: self.class.rewrite_month_fields(
               month_diff: diff, month_label: month_label, name: 'leaped'
             )
           )
         end
 
-        def self.rewrite_month_fields(month_diff:, month_label:, name:)
-          method_name = name.intern
-
-          diff = month_diff.send(method_name)
-          default = month_label.send(method_name)
-          return default if diff.invalid?
-
-          diff.actual
-        end
-
         #
         # 二十四節気ごとの差分で書き換える
         #
         def rewrite_solar_terms
-          matched, operated_solar_term = @operated_solar_terms.get(
+          matched, solar_term = operated_solar_term.get(
             western_date: first_day.western_date
           )
 
           return unless matched
 
-          @solar_terms = OperatedMonth.create_operated_solar_terms(
-            operated_solar_term: operated_solar_term,
+          @solar_terms = OperatedSolarTerm.create_operated_solar_term(
+            operated_solar_term: solar_term,
             solar_terms: solar_terms
           )
         end
 
-        #
-        # 運用情報によって改変した二十四節気を作成する
-        #
-        # @param [<Type>] operated_solar_term 運用情報（二十四節気）
-        # @param [Array<SolarTerm>] solar_terms 二十四節気
-        #
-        # @return [Array<SolarTerm>] 二十四節気
-        #
-        def self.create_operated_solar_terms(operated_solar_term:, solar_terms:)
-          index = operated_solar_term.index
-
-          # 別の月に移動する二十四節気。割り当てない。
-          result = remove_solar_term(index: index, solar_terms: solar_terms)
-
-          return result if used_solar_term?(index: index, solar_terms: solar_terms)
-
-          result.push(operated_solar_term)
-
-          result
-        end
-
-        # :reek:ControlParameter
-
-        #
-        # 二十四節気が使用されているか
-        #
-        # @param [Integer] index 二十四節気番号
-        # @param [Array<SolarTerm>] solar_terms 二十四節気
-        #
-        # @return [True] 使用
-        # @return [False] 未使用
-        #
-        def self.used_solar_term?(index:, solar_terms:)
-          solar_terms.each do |solar_term|
-            return true if index == solar_term.index
-          end
-
-          false
-        end
-
-        # :reek:ControlParameter
-
-        #
-        # 対象の二十四節気を除外する
-        #
-        # @param [Integer] index 二十四節気番号
-        # @param [Array<SolarTerm>] solar_terms 二十四節気
-        #
-        # @return [Array<SolarTerm>] 二十四節気（対象除外済）
-        #
-        def self.remove_solar_term(index:, solar_terms:)
-          result = []
-          solar_terms.each do |solar_term|
-            next if index == solar_term.index
-
-            result.push(solar_term)
-          end
-
-          result
-        end
-
         #
         # 月初日ごとの差分で書き換える
         #
         def rewrite_first_day
-          diffs = @history.diffs
+          diffs = history.diffs
           return if diffs.invalid_days?
 
           days = diffs.days
@@ -242,10 +172,31 @@ module Zakuro
           @moved = true
         end
 
+        class << self
+          #
+          # 計算結果を該当のフィールドの運用情報に書き換える
+          #
+          # @param [Operation::Diffs] month_diff 月差分
+          # @param [MonthLabel] month_label 月表示情報
+          # @param [String] name フィールド名
+          #
+          # @return [Object] 運用情報
+          #
+          def rewrite_month_fields(month_diff:, month_label:, name:)
+            method_name = name.intern
+
+            diff = month_diff.send(method_name)
+            default = month_label.send(method_name)
+            return default if diff.invalid?
+
+            diff.dest
+          end
+        end
+
         private
 
         def history_month_number
-          @history.diffs.month.number
+          history.diffs.month.number
         end
       end
     end

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

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Monthly
+      #
+      # OperatedSolarTerm 運用二十四節気
+      #
+      module OperatedSolarTerm
+        class << self
+          #
+          # 運用情報によって改変した二十四節気を作成する
+          #
+          # @param [<Type>] operated_solar_term 運用情報（二十四節気）
+          # @param [Array<SolarTerm>] solar_terms 二十四節気
+          #
+          # @return [Array<SolarTerm>] 二十四節気
+          #
+          def create_operated_solar_term(operated_solar_term:, solar_terms:)
+            index = operated_solar_term.index
+
+            # 別の月に移動する二十四節気。割り当てない。
+            result = remove_solar_term(index: index, solar_terms: solar_terms)
+
+            return result if used_solar_term?(index: index, solar_terms: solar_terms)
+
+            result.push(operated_solar_term)
+
+            result
+          end
+
+          private
+
+          # :reek:ControlParameter
+
+          #
+          # 二十四節気が使用されているか
+          #
+          # @param [Integer] index 二十四節気番号
+          # @param [Array<SolarTerm>] solar_terms 二十四節気
+          #
+          # @return [True] 使用
+          # @return [False] 未使用
+          #
+          def used_solar_term?(index:, solar_terms:)
+            solar_terms.each do |solar_term|
+              return true if index == solar_term.index
+            end
+
+            false
+          end
+
+          # :reek:ControlParameter
+
+          #
+          # 対象の二十四節気を除外する
+          #
+          # @param [Integer] index 二十四節気番号
+          # @param [Array<SolarTerm>] solar_terms 二十四節気
+          #
+          # @return [Array<SolarTerm>] 二十四節気（対象除外済）
+          #
+          def remove_solar_term(index:, solar_terms:)
+            result = []
+            solar_terms.each do |solar_term|
+              next if index == solar_term.index
+
+              result.push(solar_term)
+            end
+
+            result
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/option/dropped_date/abstract_parameter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Option
+      # :nodoc:
+      module DroppedDate
+        #
+        # AbstractParameter 没日引数
+        #
+        class AbstractParameter
+          # @return [True] 有効
+          # @return [False] 無効
+          attr_reader :valid
+          # @return [Integer] 年
+          attr_reader :year
+          # @return [Cycle::AbstractRemainder] 「有没之気」判定
+          attr_reader :limit
+          # @return [Class] 没余クラス
+          attr_reader :remainder_class
+
+          #
+          # 初期化
+          #
+          # @param [True, False] valid 有効/無効
+          # @param [Integer] year 年
+          # @param [Cycle::AbstractRemainder] limit 「有没之気」判定
+          # @param [Class] remainder_class 没余クラス
+          #
+          def initialize(valid: false, year: 0, limit: Cycle::AbstractRemainder.new,
+                         remainder_class: Object)
+            @valid = valid
+            @year = year
+            @limit = limit
+            @remainder_class = remainder_class
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/option/dropped_date/location.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Option
+      # :nodoc:
+      module DroppedDate
+        #
+        # Location 没日位置
+        #
+        class Location
+          # @return [Integer] 理想上の年日数
+          IDEAL_YEAR = 360
+
+          # @return [Context::Context] 暦コンテキスト
+          attr_reader :context
+          # @return [True] 有効
+          # @return [False] 無効
+          attr_reader :valid
+          # @return [Cycle::AbstractRemainder] 「有没之気」判定
+          attr_reader :limit
+          # @return [Integer] 年
+          attr_reader :year
+          # @return [Array<Cycle::AbstractSolarTerm>] 二十四節気
+          attr_reader :solar_terms
+          # @return [Class] 没余クラス
+          attr_reader :remainder_class
+
+          #
+          # 初期化
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Array<Cycle::AbstractSolarTerm>] solar_terms 二十四節気
+          #
+          def initialize(context:, solar_terms: [])
+            parameter = context.resolver.dropped_date_parameter.new
+            @context = context
+            @valid = parameter.valid
+            @limit = parameter.limit
+            @year = parameter.year
+            @remainder_class = parameter.remainder_class
+            @solar_terms = solar_terms
+          end
+
+          #
+          # 不正か
+          #
+          # @return [True] 不正
+          # @return [False] 不正なし
+          #
+          def invalid?
+            !@valid
+          end
+
+          #
+          # 没日が存在するか？
+          #
+          # @return [True] 存在あり
+          # @return [False] 存在なし
+          #
+          def exist?
+            !solar_term_remainder.invalid?
+          end
+
+          #
+          # 「没余」を返す
+          #
+          # @return [Cycle::AbstractRemainder] 没余
+          #
+          def get
+            # 1. 二十四節気の大余小余を取り出す
+            remainder = solar_term_remainder
+            # 2. 小余360、秒45（360/8）で乗算する
+            total = multiple_ideal_year(remainder: remainder)
+            # 3. 上記2と章歳（3068055）の差を求める
+            diff = (year - total).abs
+            # 4. 上記3を通余で徐算する
+            result = remainder_class.new(total: diff)
+            # 5. 上記4の商と上記1の大余が没日大余、余りが小余（没余）
+            day = remainder_class.new(day: remainder.day, minute: 0, second: 0)
+
+            day.add(result)
+          end
+
+          #
+          # 該当の二十四節気を取得する
+          #
+          # @return [Cycle::AbstractSolarTerm] 二十四節気
+          #
+          def solar_term
+            solar_terms.each do |solar_term|
+              remainder = solar_term.remainder.clone
+              minute_later = remainder.class.new(
+                day: 0, minute: remainder.minute, second: remainder.second
+              )
+
+              return solar_term if minute_later >= limit
+            end
+
+            context.resolver.solar_term.new
+          end
+
+          private
+
+          #
+          # 二十四節気の大余小余を取得する
+          #
+          # @return [Type::Optional<Cycle::AbstractRemainder>] 大余小余
+          #
+          def solar_term_remainder
+            solar_term.remainder
+          end
+
+          #
+          # 理想上の年数を乗算する
+          #
+          #  宣明暦：小余360、秒45（360/8）で積算する
+          #
+          # @return [Cycle::AbstractRemainder] 大余小余
+          #
+          # @return [Integer] 乗算結果
+          #
+          def multiple_ideal_year(remainder:)
+            minute = remainder.minute * IDEAL_YEAR
+            second = remainder.second * (IDEAL_YEAR / remainder.base_minute)
+            minute + second
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/range/{full_range.rb → abstract_full_range.rb}

@@ -1,11 +1,10 @@
 # frozen_string_literal: true
 
-require_relative '../../version/context'
+require_relative '../../context/context'
 
 require_relative '../../era/western/calendar'
 require_relative '../../output/logger'
 
-require_relative '../era/gengou/scroll'
 require_relative '../era/version/version'
 
 require_relative '../base/gengou'
@@ -35,8 +34,8 @@ module Zakuro
       #   * 引き当てたい日付が元旦ではない場合、その月日に従い元号を再度求める
       #   * この再計算が必要になるのは、元号が切り替わる年のみである
       #
-      class FullRange
-        # @return [Context] 暦コンテキスト
+      class AbstractFullRange
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
         # @return [Western::Calendar] 開始日
         attr_reader :start_date
@@ -51,18 +50,19 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
         #
-        def initialize(context:, start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+        def initialize(context:, scroll:,
+                       start_date: Western::Calendar.new, last_date: Western::Calendar.new)
           @start_date = start_date
           @last_date = last_date
           return if invalid?
 
-          # TODO: 現時点では使用していない。特定の暦を指定できるようになった状態で使用する
           @context = context
-          @scroll = Gengou::Scroll.new(start_date: start_date, last_date: last_date)
+          @scroll = scroll
         end
 
         #
@@ -72,7 +72,7 @@ module Zakuro
         # @return [False] 有効
         #
         def invalid?
-          @start_date.invalid?
+          start_date.invalid?
         end
 
         #
@@ -100,33 +100,19 @@ module Zakuro
         # @return [Array<Base::Year>] 完全範囲
         #
         def version_ranges
-          result = []
-
-          start_year = @scroll.western_start_year
-          last_year = @scroll.western_last_year
+          start_year = scroll.western_start_year
+          last_year = scroll.western_last_year
 
+          # TODO: context にデフォルト暦名が設定されている場合は使用しない
           versions = Version.get(start_year: start_year, last_year: last_year)
 
-          versions.each_with_index do |version, index|
-            context = Context.new(version_name: version.name)
-            start_year = version.start_year
-            last_year = version.last_year
-            # 最後の暦だけ1年足す（次の元号の開始年まで計算するケースあり）
-            last_year += 1 if (index + 1) == versions.size
-
-            years = boundary_resolved_ranges(
-              context: context, start_year: start_year, last_year: last_year
-            )
-            result.concat(years)
-          end
-
-          result
+          collect_version_ranges(versions: versions, start_year: start_year, last_year: last_year)
         end
 
         #
         # 年境界解決済みの範囲
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
         # @param [Integer] last_year 終了西暦年
         #
@@ -145,7 +131,7 @@ module Zakuro
         #
         # 完全範囲内の年データを取得する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
         # @param [Integer] last_year 終了西暦年
         #
@@ -165,6 +151,36 @@ module Zakuro
 
           years
         end
+
+        #
+        # 暦別範囲を収集する
+        #
+        # @param [Array<Version::Range>] versions 暦の範囲
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        # @return [Array<Base::Year>] 完全範囲
+        #
+        def collect_version_ranges(versions:, start_year:, last_year:)
+          result = []
+
+          versions.each_with_index do |version, index|
+            specified_context = Context::Context.new(
+              version: version.name, options: context.option.hash
+            )
+            start_year = version.start_year
+            last_year = version.last_year
+            # 最後の暦だけ1年足す（次の元号の開始年まで計算するケースあり）
+            last_year += 1 if (index + 1) == versions.size
+
+            years = boundary_resolved_ranges(
+              context: specified_context, start_year: start_year, last_year: last_year
+            )
+            result.concat(years)
+          end
+
+          result
+        end
       end
     end
   end