decentworks-date-support 0.1.0 → 0.2.0

data/lib/decentworks/date_support/time_with_zone.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "active_support"
+require "active_support/time" # ::ActiveSupport::TimeWithZone の定義元
+
+require_relative "time_extension"
+
+module ActiveSupport
+  class TimeWithZone
+    include ::Decentworks::DateSupport::TimeExtension
+  end
+end

data/lib/decentworks/date_support/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Decentworks
+  module DateSupport
+    VERSION = "0.2.0"
+  end
+end

data/lib/decentworks/date_support.rb

@@ -1,323 +1,10 @@
 # frozen_string_literal: true
 
-require "date"
-
-module Decentworks
-  module DateSupport
-    refine ::Date do
-      # ###############################################################################################################
-      # 週関係
-      # ###############################################################################################################
-
-      #
-      # 今週
-      #
-
-      # 現在の日付が属する週の始まりの日付
-      #
-      # @param beginning_of_week 週の始まりの曜日。省略した場合は、config.beginning_of_weekの設定に従います。
-      def beginning_of_this_week(beginning_of_week = nil)
-        beginning_of_week(beginning_of_week.presence || ::Date.beginning_of_week) # steep:ignore NoMethod
-      end
-
-      # 現在の日付が属する週の終わりの日付
-      #
-      # @param beginning_of_week 週の始まりの曜日。省略した場合は、config.beginning_of_weekの設定に従います。
-      def end_of_this_week(beginning_of_week = nil)
-        next_week # steep:ignore NoMethod
-          .beginning_of_this_week(beginning_of_week)
-          .yesterday
-      end
-
-      # 今週の期間
-      #
-      # @param beginning_of_week 週の始まりの曜日。省略した場合は、config.beginning_of_weekの設定に従います。
-      def all_this_week(beginning_of_week = nil)
-        ::Range.new(
-          beginning_of_this_week(beginning_of_week),
-          end_of_this_week(beginning_of_week)
-        )
-      end
-
-      # ###############################################################################################################
-      # 月関係
-      # ###############################################################################################################
-
-      #
-      # 今月関係
-      #
-
-      # 現在の日付が属する月の期間
-      def all_this_month
-        ::Range.new(
-          beginning_of_month.to_date, # steep:ignore NoMethod
-          end_of_month.to_date        # steep:ignore NoMethod
-        )
-      end
-
-      #
-      # Nヶ月前関係
-      #
-
-      # 2ヶ月前の日付
-      def two_months_ago = months_ago(2) # steep:ignore NoMethod
-
-      # 3ヶ月前の日付
-      def three_months_ago = months_ago(3) # steep:ignore NoMethod
-
-      # 4ヶ月前の日付
-      def four_months_ago = months_ago(4) # steep:ignore NoMethod
-
-      # 5ヶ月前の日付
-      def five_months_ago = months_ago(5) # steep:ignore NoMethod
-
-      # 6ヶ月前の日付
-      def six_months_ago = months_ago(6) # steep:ignore NoMethod
-
-      # 半年前の日
-      alias_method :half_year_ago, :six_months_ago
-
-      # 7ヶ月前の日付
-      def seven_months_ago = months_ago(7) # steep:ignore NoMethod
-
-      # 8ヶ月前の日付
-      def eight_months_ago = months_ago(8) # steep:ignore NoMethod
-
-      # 9ヶ月前の日付
-      def nine_months_ago = months_ago(9) # steep:ignore NoMethod
-
-      # 10ヶ月前の日付
-      def ten_months_ago = months_ago(10) # steep:ignore NoMethod
-
-      # 11ヶ月前の日付
-      def eleven_months_ago = months_ago(11) # steep:ignore NoMethod
-
-      #
-      # Nヶ月後関係
-      #
-
-      # 2ヶ月後の日付
-      def two_months_since = months_since(2) # steep:ignore NoMethod
-
-      # 3ヶ月後の日付
-      def three_months_since = months_since(3) # steep:ignore NoMethod
-
-      # 4ヶ月後の日付
-      def four_months_since = months_since(4) # steep:ignore NoMethod
-
-      # 5ヶ月後の日付
-      def five_months_since = months_since(5) # steep:ignore NoMethod
-
-      # 6ヶ月後の日付
-      def six_months_since = months_since(6) # steep:ignore NoMethod
-
-      # 半年前の日
-      alias_method :half_year_since, :six_months_since
-
-      # 7ヶ月後の日付
-      def seven_months_since = months_since(7) # steep:ignore NoMethod
-
-      # 8ヶ月後の日付
-      def eight_months_since = months_since(8) # steep:ignore NoMethod
-
-      # 9ヶ月後の日付
-      def nine_months_since = months_since(9) # steep:ignore NoMethod
-
-      # 10ヶ月後の日付
-      def ten_months_since = months_since(10) # steep:ignore NoMethod
-
-      # 11ヶ月後の日付
-      def eleven_months_since = months_since(11) # steep:ignore NoMethod
-
-      #
-      # 暦月関係
-      #
-
-      # 1月の月初
-      def beginning_of_january = change(month: 1, day: 1) # steep:ignore NoMethod
-
-      # 1月の月末
-      def end_of_january = beginning_of_january.end_of_month
-
-      # 1月の期間
-      def all_january = ::Range.new(beginning_of_january, end_of_january)
-
-      # 2月の月初
-      def beginning_of_february = change(month: 2, day: 1) # steep:ignore NoMethod
-
-      # 2月の月末
-      def end_of_february = beginning_of_february.end_of_month
-
-      # 2月の期間
-      def all_february = ::Range.new(beginning_of_february, end_of_february)
-
-      # 3月の月初
-      def beginning_of_march = change(month: 3, day: 1) # steep:ignore NoMethod
-
-      # 3月の月末
-      def end_of_march = beginning_of_march.end_of_month
-
-      # 3月の期間
-      def all_march = ::Range.new(beginning_of_march, end_of_march)
-
-      # 4月の月初
-      def beginning_of_april = change(month: 4, day: 1) # steep:ignore NoMethod
-
-      # 4月の月末
-      def end_of_april = beginning_of_april.end_of_month
-
-      # 4月の期間
-      def all_april = ::Range.new(beginning_of_april, end_of_april)
-
-      # 5月の月初
-      def beginning_of_may = change(month: 5, day: 1) # steep:ignore NoMethod
-
-      # 5月の月末
-      def end_of_may = beginning_of_may.end_of_month
-
-      # 5月の期間
-      def all_may = ::Range.new(beginning_of_may, end_of_may)
-
-      # 6月の月初
-      def beginning_of_june = change(month: 6, day: 1) # steep:ignore NoMethod
-
-      # 6月の月末
-      def end_of_june = beginning_of_june.end_of_month
-
-      # 6月の期間
-      def all_june = ::Range.new(beginning_of_june, end_of_june)
-
-      # 7月の月初
-      def beginning_of_july = change(month: 7, day: 1) # steep:ignore NoMethod
-
-      # 7月の月末
-      def end_of_july = beginning_of_july.end_of_month
-
-      # 7月の期間
-      def all_july = ::Range.new(beginning_of_july, end_of_july)
-
-      # 8月の月初
-      def beginning_of_august = change(month: 8, day: 1) # steep:ignore NoMethod
-
-      # 8月の月末
-      def end_of_august = beginning_of_august.end_of_month
-
-      # 8月の期間
-      def all_august = ::Range.new(beginning_of_august, end_of_august)
-
-      # 9月の月初
-      def beginning_of_september = change(month: 9, day: 1) # steep:ignore NoMethod
-
-      # 9月の月末
-      def end_of_september = beginning_of_september.end_of_month
-
-      # 9月の期間
-      def all_september = ::Range.new(beginning_of_september, end_of_september)
-
-      # 10月の月初
-      def beginning_of_october = change(month: 10, day: 1) # steep:ignore NoMethod
-
-      # 10月の月末
-      def end_of_october = beginning_of_october.end_of_month
-
-      # 10月の期間
-      def all_october = ::Range.new(beginning_of_october, end_of_october)
-
-      # 11月の月初
-      def beginning_of_november = change(month: 11, day: 1) # steep:ignore NoMethod
-
-      # 11月の月末
-      def end_of_november = beginning_of_november.end_of_month
-
-      # 11月の期間
-      def all_november = ::Range.new(beginning_of_november, end_of_november)
-
-      # 12月の月初
-      def beginning_of_december = change(month: 12, day: 1) # steep:ignore NoMethod
-
-      # 12月の月末
-      def end_of_december = beginning_of_december.end_of_month
-
-      # 12月の期間
-      def all_december = ::Range.new(beginning_of_december, end_of_december)
-
-      # ###############################################################################################################
-      # 四半期関係
-      # ###############################################################################################################
-
-      # 第1四半期の始めの日付
-      alias_method :beginning_of_first_quarter, :beginning_of_january
-
-      # 第1四半期の終わりの日付
-      alias_method :end_of_first_quarter, :end_of_march
-
-      # 第1四半期の期間
-      def all_first_quarter = ::Range.new(beginning_of_first_quarter, end_of_first_quarter)
-
-      # 第2四半期の始めの日付
-      alias_method :beginning_of_second_quarter, :beginning_of_april
-
-      # 第2四半期の終わりの日付
-      alias_method :end_of_second_quarter, :end_of_june
-
-      # 第2四半期の期間
-      def all_second_quarter = ::Range.new(beginning_of_second_quarter, end_of_second_quarter)
-
-      # 第3四半期の始めの日付
-      alias_method :beginning_of_third_quarter, :beginning_of_july
-
-      # 第3四半期の終わりの日付
-      alias_method :end_of_third_quarter, :end_of_september
-
-      # 第3四半期の期間
-      def all_third_quarter = ::Range.new(beginning_of_third_quarter, end_of_third_quarter)
-
-      # 第4四半期の始めの日付
-      alias_method :beginning_of_fourth_quarter, :beginning_of_october
-
-      # 第4四半期の終わりの日付
-      alias_method :end_of_fourth_quarter, :end_of_december
-
-      # 第4四半期の期間
-      def all_fourth_quarter = ::Range.new(beginning_of_fourth_quarter, end_of_fourth_quarter)
-
-      # ###############################################################################################################
-      # 上下期関係
-      # ###############################################################################################################
-
-      # 上期の始まりの日付
-      alias_method :beginning_of_first_half, :beginning_of_first_quarter
-
-      # 上期の終わりの日付
-      alias_method :end_of_first_half, :end_of_second_quarter
-
-      # 上期の期間
-      def all_first_half = ::Range.new(beginning_of_first_half, end_of_first_half)
-
-      # 下期の始まりの日付
-      alias_method :beginning_of_second_half, :beginning_of_third_quarter
-
-      # 下期の終わりの日付
-      alias_method :end_of_second_half, :end_of_fourth_quarter
-
-      # 下期の期間
-      def all_second_half = ::Range.new(beginning_of_second_half, end_of_second_half)
-    end
-
-    refine ::Date.singleton_class do
-      # ###############################################################################################################
-      # 満経過月数
-      # ###############################################################################################################
-
-      # 満経過月数
-      # steep:ignore:start
-      def whole_months_elapsed(from:, to:)
-        diff_year = to.year - from.year
-        diff_month = to.month - from.month
-
-        (diff_year * 12) + diff_month - (to.day >= from.day ? 0 : 1)
-      end
-      # steep:ignore:end
-    end
-  end
-end
+require_relative "date_support/version"
+require_relative "date_support/configuration"
+require_relative "date_support/date_extension"
+require_relative "date_support/date"
+require_relative "date_support/time_extension"
+require_relative "date_support/time"
+require_relative "date_support/date_time"
+require_relative "date_support/time_with_zone"

data/lib/decentworks-date-support.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "decentworks/date_support"

data/lib/generators/decentworks/date_support/install/install_generator.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module Decentworks
+  module DateSupport
+    module Generators
+      # config/initializers/decentworks_date_support.rb を生成するジェネレータ
+      #
+      # @example
+      #   bin/rails generate decentworks:date_support:install
+      class InstallGenerator < ::Rails::Generators::Base
+        source_root File.expand_path("templates", __dir__)
+
+        desc "config/initializers/decentworks_date_support.rb を生成します。"
+
+        def create_initializer_file
+          template(
+            "decentworks_date_support.rb.tt",
+            "config/initializers/decentworks_date_support.rb"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/generators/decentworks/date_support/install/templates/decentworks_date_support.rb.tt

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+::Decentworks::DateSupport.configure do |config|
+  # 第1四半期（上期）の開始月を指定します。
+  # 指定可能な値:
+  #   :january   # =>  1月
+  #   :february  # =>  2月
+  #   :march     # =>  3月
+  #   :april     # =>  4月
+  #   :may       # =>  5月
+  #   :june      # =>  6月
+  #   :july      # =>  7月
+  #   :august    # =>  8月
+  #   :september # =>  9月
+  #   :october   # => 10月
+  #   :november  # => 11月
+  #   :december  # => 12月
+
+  config.first_quarter_month_name = :january # 1月始まり
+  # 第1四半期：1月〜3月
+  # 第2四半期：4月〜6月
+  # 第3四半期：7月〜9月
+  # 第4四半期：10月〜12月
+  # 上期：1月〜6月
+  # 下期：7月〜12月
+
+  # config.first_quarter_month_name = :april # 4月始まり
+  # 第1四半期：4月〜6月
+  # 第2四半期：7月〜9月
+  # 第3四半期：10月〜12月
+  # 第4四半期：翌1月〜翌3月
+  # 上期：4月〜9月
+  # 下期：10月〜翌3月
+
+  # config.first_quarter_month_name = :july # 7月始まり
+  # 第1四半期：7月〜9月
+  # 第2四半期：10月〜12月
+  # 第3四半期：翌1月〜翌3月
+  # 第4四半期：翌4月〜翌6月
+  # 上期：7月〜12月
+  # 下期：翌1月〜翌6月
+
+  # config.first_quarter_month_name = :october # 10月始まり
+  # 第1四半期：10月〜12月
+  # 第2四半期：翌1月〜翌3月
+  # 第3四半期：翌4月〜翌6月
+  # 第4四半期：翌7月〜翌9月
+  # 上期：10月〜翌3月
+  # 下期：翌4月〜翌9月
+end

data/sig/decentworks/date_support/configuration.rbs

@@ -0,0 +1,25 @@
+module Decentworks
+  module DateSupport
+    def self.configure: () ?{ (::Decentworks::DateSupport::Configuration) -> void } -> void
+    def self.configuration: -> ::Decentworks::DateSupport::Configuration
+
+    def self.reset_configuration!: -> nil
+
+    def self.first_quarter_month_name: -> Symbol
+    def self.first_quarter_month: -> Integer
+    def self.first_quarter_month_offset: -> Integer
+
+    class Configuration
+      MONTHS: Hash[Symbol, Integer]
+      DEFAULT: Symbol
+
+      attr_reader first_quarter_month_name: Symbol
+
+      def first_quarter_month_name=: (Symbol) -> void
+
+      def first_quarter_month: -> Integer
+
+      def first_quarter_month_offset: -> Integer
+    end
+  end
+end

data/sig/decentworks/date_support/date.rbs

@@ -0,0 +1,4 @@
+class Date
+  include ::Decentworks::DateSupport::DateExtension
+  extend ::Decentworks::DateSupport::DateExtension::ClassMethods
+end