decentworks-date-support 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e9dfe6b36ab7e84d333bb4562533c8552fac643b805ad2839948d93bc001740
-  data.tar.gz: 3ef12c40ef40af471f5ef8bf8ef5a3b73ab44e372c091c41b41674bc0894d978
+  metadata.gz: ecd2667a864d2b7d807244bea27aa807fcb2f23f425766efef2544be928650ae
+  data.tar.gz: 8f256c1fefaf7f66e8dd79b761f160d32c29dcee7b9bada4f4f02cb91e256657
 SHA512:
-  metadata.gz: c85f09c4a5579df1c9108f49a2950cea6a7b29ad91f05a38a5963a23e0351b0227fa7c799d44a89ec0300ba73a4ac5ef0279deeab1baab3c69ff64be68b475d7
-  data.tar.gz: 883158b0abd8e2c1e7e4184a82d4545795f1a91b5660eddbfaa79c72ea50bcb9ed1cd750cc2bf6c36389246156a6266bd566e2a7842e3d871832800982bba128
+  metadata.gz: a1b3b1e9af91fb7cb31cc3e1ff97352a411d8bf9bc086e60cebd318a2fcefb0763951c19248123392d69284399f207f8b7a3c9bcb3d3c0dc1d4031bd7c709ecf
+  data.tar.gz: 873b03a25a370618596c948f8e061d6cfaf93d0cca9ff150b3bd07609c4121aff7e5edfdcc210604a346127d4c1dd27134feeb1af6ac074e11d82e69bf551d5b

data/CHANGELOG.md

@@ -1,5 +1,10 @@
-## [Unreleased]
+# [0.1.1]
 
-## [0.1.0] - 2026-08-04
+- [四半期、上下期の開始日を設定できるようにする #1](https://github.com/SrDecentWorks/decentworks-date-support/issues/1)
+- [週の始まりの曜日の指定を引数から削除 #3](https://github.com/SrDecentWorks/decentworks-date-support/issues/3)
+- Gem内のファイル構成をリファクタリング
 
-- Initial release
+# [0.1.0]
+
+- 初期リリース
+- gem開発実験中

data/README.md

@@ -1,11 +1,39 @@
 # Decentworks::Date::Support - 日付機能拡張ライブラリ
 
+## はじめに
+
+このgemは、個人開発用です。  
+そのため、予告なく仕様の追加・変更・削除が行われます。  
+もちろん、このgemを使用したことによるバグなどの責任は負えません。
+
 ## 概要
 
 Railsの`Date`、`ActiveSupport::TimeWithZone`に対する機能拡張を行います。
 
+## refinements
+
+gemによる影響範囲を限定するため、refinementsを採用しています。  
+利用する場合は、適切なスコープで`using`を利用してください。
+
 ## 機能
 
+### Dateクラス拡張
+
+#### using
+
+```ruby
+using ::Decentworks::DateSupport
+```
+
+### ActiveSupport::TimeWithZoneクラス拡張
+
+#### using
+
+```ruby
+using ::Decentworks::ActiveSupport::TimeWithZoneSupport
+```
+
+
 ### 週関係
 
 - 週の始まりの曜日を指定しての日付・期間の取得
@@ -33,22 +61,33 @@ Railsの`Date`、`ActiveSupport::TimeWithZone`に対する機能拡張を行い
 gem 'decentworks-date-support'
 ```
 
+### 初期化ファイルの生成（Rails）
+
+Railsから利用する場合は、以下のジェネレータで`config/initializers/decentworks_date_support.rb`を生成できます。
+
+```shell
+bin/rails generate decentworks:date_support:install
+```
+
+- 初期値は1月始まりです。
+- その他の月に変更したい場合は、ファイルの内容を修正してください。
+
 ## 使い方の例
 
 ```ruby
-require 'decentworks_date_support'
+require 'decentworks/date_support'
 
 using ::Decentworks::DateSupport
 
 d = ::Date.new(2026, 8, 5)
-d.all_this_week(:sunday) # => ::Date.new(2026, 8, 2)..::Date.new(2026, 8, 8)
+d.all_this_week # => Mon, 03 Aug 2026..Sun, 09 Aug 2026
 ```
 
 ```ruby
-require 'decentworks_date_support'
+require 'decentworks/date_support'
 
 using ::Decentworks::ActiveSupport::TimeWithZoneSupport
 
 d = ::Time.zone.local(2026, 8, 5)
-d.all_this_week(:sunday) # => ::Date.new(2026, 8, 2).beginning_of_day..::Date.new(2026, 8, 8).end_of_day
+d.all_this_week # => 2026-08-03 00:00:00.000000000 JST +09:00..2026-08-09 23:59:59.999999999 JST +09:00
 ```

data/lib/decentworks/active_support/time_with_zone_support.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 require "date"
-require "decentworks/date_support"
+require "active_support/time"
+require_relative "../date_support/date" # using ::Decentworks::DateSupport に必要
 
 module Decentworks
   module ActiveSupport
@@ -18,34 +19,13 @@ module Decentworks
         #
 
         # 現在の日付が属する週の始まりの日付
-        #
-        # @param beginning_of_week 週の始まりの曜日。省略した場合は、config.beginning_of_weekの設定に従います。
-        def beginning_of_this_week(beginning_of_week = nil)
-          to_date # steep:ignore NoMethod
-            .beginning_of_this_week(beginning_of_week)
-            .beginning_of_day
-        end
+        def beginning_of_this_week = to_date.beginning_of_this_week.beginning_of_day
 
         # 現在の日付が属する週の終わりの日付
-        #
-        # @param beginning_of_week 週の始まりの曜日。省略した場合は、config.beginning_of_weekの設定に従います。
-        def end_of_this_week(beginning_of_week = nil)
-          to_date # steep:ignore NoMethod
-            .next_week
-            .beginning_of_this_week(beginning_of_week)
-            .yesterday
-            .end_of_day
-        end
+        def end_of_this_week = to_date.next_week.beginning_of_this_week.yesterday.end_of_day
 
         # 今週の期間
-        #
-        # @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_week = ::Range.new(beginning_of_this_week, end_of_this_week)
 
         # #############################################################################################################
         # 月関係
@@ -136,6 +116,10 @@ module Decentworks
         # 暦月関係
         #
 
+        #
+        # 1月
+        #
+
         # 1月の月初
         def beginning_of_january = to_date.beginning_of_january.beginning_of_day # steep:ignore NoMethod
 
@@ -145,6 +129,19 @@ module Decentworks
         # 1月の期間
         def all_january = ::Range.new(beginning_of_january, end_of_january)
 
+        # 1月の月初か？
+        def beginning_of_january? = beginning_of_january.all_day.cover?(self)
+
+        # 1月の月末か？
+        def end_of_january? = end_of_january.all_day.cover?(self)
+
+        # 1月か？
+        def in_january? = all_january.cover?(self)
+
+        #
+        # 2月
+        #
+
         # 2月の月初
         def beginning_of_february = to_date.beginning_of_february.beginning_of_day # steep:ignore NoMethod
 
@@ -154,6 +151,19 @@ module Decentworks
         # 2月の期間
         def all_february = ::Range.new(beginning_of_february, end_of_february)
 
+        # 2月の月初か？
+        def beginning_of_february? = beginning_of_february.all_day.cover?(self)
+
+        # 2月の月末か？
+        def end_of_february? = end_of_february.all_day.cover?(self)
+
+        # 2月か？
+        def in_february? = all_february.cover?(self)
+
+        #
+        # 3月
+        #
+
         # 3月の月初
         def beginning_of_march = to_date.beginning_of_march.beginning_of_day # steep:ignore NoMethod
 
@@ -163,6 +173,19 @@ module Decentworks
         # 3月の期間
         def all_march = ::Range.new(beginning_of_march, end_of_march)
 
+        # 3月の月初か？
+        def beginning_of_march? = beginning_of_march.all_day.cover?(self)
+
+        # 3月の月末か？
+        def end_of_march? = end_of_march.all_day.cover?(self)
+
+        # 3月か？
+        def in_march? = all_march.cover?(self)
+
+        #
+        # 4月
+        #
+
         # 4月の月初
         def beginning_of_april = to_date.beginning_of_april.beginning_of_day # steep:ignore NoMethod
 
@@ -172,6 +195,19 @@ module Decentworks
         # 4月の期間
         def all_april = ::Range.new(beginning_of_april, end_of_april)
 
+        # 4月の月初か？
+        def beginning_of_april? = beginning_of_april.all_day.cover?(self)
+
+        # 4月の月末か？
+        def end_of_april? = end_of_april.all_day.cover?(self)
+
+        # 4月か？
+        def in_april? = all_april.cover?(self)
+
+        #
+        # 5月
+        #
+
         # 5月の月初
         def beginning_of_may = to_date.beginning_of_may.beginning_of_day # steep:ignore NoMethod
 
@@ -181,6 +217,19 @@ module Decentworks
         # 5月の期間
         def all_may = ::Range.new(beginning_of_may, end_of_may)
 
+        # 5月の月初か？
+        def beginning_of_may? = beginning_of_may.all_day.cover?(self)
+
+        # 5月の月末か？
+        def end_of_may? = end_of_may.all_day.cover?(self)
+
+        # 5月か？
+        def in_may? = all_may.cover?(self)
+
+        #
+        # 6月
+        #
+
         # 6月の月初
         def beginning_of_june = to_date.beginning_of_june.beginning_of_day # steep:ignore NoMethod
 
@@ -190,6 +239,19 @@ module Decentworks
         # 6月の期間
         def all_june = ::Range.new(beginning_of_june, end_of_june)
 
+        # 6月の月初か？
+        def beginning_of_june? = beginning_of_june.all_day.cover?(self)
+
+        # 6月の月末か？
+        def end_of_june? = end_of_june.all_day.cover?(self)
+
+        # 6月か？
+        def in_june? = all_june.cover?(self)
+
+        #
+        # 7月
+        #
+
         # 7月の月初
         def beginning_of_july = to_date.beginning_of_july.beginning_of_day # steep:ignore NoMethod
 
@@ -199,6 +261,19 @@ module Decentworks
         # 7月の期間
         def all_july = ::Range.new(beginning_of_july, end_of_july)
 
+        # 7月の月初か？
+        def beginning_of_july? = beginning_of_july.all_day.cover?(self)
+
+        # 7月の月末か？
+        def end_of_july? = end_of_july.all_day.cover?(self)
+
+        # 7月か？
+        def in_july? = all_july.cover?(self)
+
+        #
+        # 8月
+        #
+
         # 8月の月初
         def beginning_of_august = to_date.beginning_of_august.beginning_of_day # steep:ignore NoMethod
 
@@ -208,6 +283,19 @@ module Decentworks
         # 8月の期間
         def all_august = ::Range.new(beginning_of_august, end_of_august)
 
+        # 8月の月初か？
+        def beginning_of_august? = beginning_of_august.all_day.cover?(self)
+
+        # 8月の月末か？
+        def end_of_august? = end_of_august.all_day.cover?(self)
+
+        # 8月か？
+        def in_august? = all_august.cover?(self)
+
+        #
+        # 9月
+        #
+
         # 9月の月初
         def beginning_of_september = to_date.beginning_of_september.beginning_of_day # steep:ignore NoMethod
 
@@ -217,6 +305,19 @@ module Decentworks
         # 9月の期間
         def all_september = ::Range.new(beginning_of_september, end_of_september)
 
+        # 9月の月初か？
+        def beginning_of_september? = beginning_of_september.all_day.cover?(self)
+
+        # 9月の月末か？
+        def end_of_september? = end_of_september.all_day.cover?(self)
+
+        # 9月か？
+        def in_september? = all_september.cover?(self)
+
+        #
+        # 10月
+        #
+
         # 10月の月初
         def beginning_of_october = to_date.beginning_of_october.beginning_of_day # steep:ignore NoMethod
 
@@ -226,6 +327,19 @@ module Decentworks
         # 10月の期間
         def all_october = ::Range.new(beginning_of_october, end_of_october)
 
+        # 10月の月初か？
+        def beginning_of_october? = beginning_of_october.all_day.cover?(self)
+
+        # 10月の月末か？
+        def end_of_october? = end_of_october.all_day.cover?(self)
+
+        # 10月か？
+        def in_october? = all_october.cover?(self)
+
+        #
+        # 11月
+        #
+
         # 11月の月初
         def beginning_of_november = to_date.beginning_of_november.beginning_of_day # steep:ignore NoMethod
 
@@ -235,6 +349,19 @@ module Decentworks
         # 11月の期間
         def all_november = ::Range.new(beginning_of_november, end_of_november)
 
+        # 11月の月初か？
+        def beginning_of_november? = beginning_of_november.all_day.cover?(self)
+
+        # 11月の月末か？
+        def end_of_november? = end_of_november.all_day.cover?(self)
+
+        # 11月か？
+        def in_november? = all_november.cover?(self)
+
+        #
+        # 12月
+        #
+
         # 12月の月初
         def beginning_of_december = to_date.beginning_of_december.beginning_of_day # steep:ignore NoMethod
 
@@ -244,67 +371,154 @@ module Decentworks
         # 12月の期間
         def all_december = ::Range.new(beginning_of_december, end_of_december)
 
+        # 12月の月初か？
+        def beginning_of_december? = beginning_of_december.all_day.cover?(self)
+
+        # 12月の月末か？
+        def end_of_december? = end_of_december.all_day.cover?(self)
+
+        # 12月か？
+        def in_december? = all_december.cover?(self)
+
         # #############################################################################################################
         # 四半期関係
         # #############################################################################################################
 
-        # 第1四半期の始めの日付
-        alias_method :beginning_of_first_quarter, :beginning_of_january
+        #
+        # 第1四半期
+        #
+
+        # 第1四半期の期首
+        def beginning_of_first_quarter = to_date.beginning_of_first_quarter.beginning_of_day
 
-        # 第1四半期の終わりの日付
-        alias_method :end_of_first_quarter, :end_of_march
+        # 第1四半期の期末
+        def end_of_first_quarter = to_date.end_of_first_quarter.end_of_day
 
         # 第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
+        # 第1四半期の期首か？
+        def beginning_of_first_quarter? = beginning_of_first_quarter.all_day.cover?(self)
+
+        # 第1四半期の期末か？
+        def end_of_first_quarter? = end_of_first_quarter.all_day.cover?(self)
+
+        # 第1四半期か？
+        def in_first_quarter? = all_first_quarter.cover?(self)
+
+        #
+        # 第2四半期
+        #
 
-        # 第2四半期の終わりの日付
-        alias_method :end_of_second_quarter, :end_of_june
+        # 第2四半期の期首
+        def beginning_of_second_quarter = to_date.beginning_of_second_quarter.beginning_of_day
+
+        # 第2四半期の期末
+        def end_of_second_quarter = to_date.end_of_second_quarter.end_of_day
 
         # 第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
+        # 第2四半期の期首か？
+        def beginning_of_second_quarter? = beginning_of_second_quarter.all_day.cover?(self)
+
+        # 第2四半期の期末か？
+        def end_of_second_quarter? = end_of_second_quarter.all_day.cover?(self)
+
+        # 第2四半期か？
+        def in_second_quarter? = all_second_quarter.cover?(self)
+
+        #
+        # 第3四半期
+        #
+
+        # 第3四半期の期首
+        def beginning_of_third_quarter = to_date.beginning_of_third_quarter.beginning_of_day
 
-        # 第3四半期の終わりの日付
-        alias_method :end_of_third_quarter, :end_of_september
+        # 第3四半期の期末
+        def end_of_third_quarter = to_date.end_of_third_quarter.end_of_day
 
         # 第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
+        # 第3四半期の期首か？
+        def beginning_of_third_quarter? = beginning_of_third_quarter.all_day.cover?(self)
 
-        # 第4四半期の終わりの日付
-        alias_method :end_of_fourth_quarter, :end_of_december
+        # 第3四半期の期末か？
+        def end_of_third_quarter? = end_of_third_quarter.all_day.cover?(self)
+
+        # 第3四半期か？
+        def in_third_quarter? = all_third_quarter.cover?(self)
+
+        #
+        # 第4四半期
+        #
+
+        # 第4四半期の期首
+        def beginning_of_fourth_quarter = to_date.beginning_of_fourth_quarter.beginning_of_day
+
+        # 第4四半期の期末
+        def end_of_fourth_quarter = to_date.end_of_fourth_quarter.end_of_day
 
         # 第4四半期の期間
         def all_fourth_quarter = ::Range.new(beginning_of_fourth_quarter, end_of_fourth_quarter)
 
+        # 第4四半期の期首か？
+        def beginning_of_fourth_quarter? = beginning_of_fourth_quarter.all_day.cover?(self)
+
+        # 第4四半期の期末か？
+        def end_of_fourth_quarter? = end_of_fourth_quarter.all_day.cover?(self)
+
+        # 第4四半期か？
+        def in_fourth_quarter? = all_fourth_quarter.cover?(self)
+
         # #############################################################################################################
         # 上下期関係
         # #############################################################################################################
 
-        # 上期の始まりの日付
+        #
+        # 上期
+        #
+
+        # 上期の期首
         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)
 
-        # 下期の始まりの日付
+        # 上期の期首か？
+        def beginning_of_first_half? = beginning_of_first_half.all_day.cover?(self)
+
+        # 上期の期末か？
+        def end_of_first_half? = end_of_first_half.all_day.cover?(self)
+
+        # 上期か？
+        def in_first_half? = all_first_half.cover?(self)
+
+        #
+        # 下期
+        #
+
+        # 下期の期首
         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)
+
+        # 下期の期首か？
+        def beginning_of_second_half? = beginning_of_second_half.all_day.cover?(self)
+
+        # 下期の期末か？
+        def end_of_second_half? = end_of_second_half.all_day.cover?(self)
+
+        # 下期か？
+        def in_second_half? = all_second_half.cover?(self)
       end
 
       refine ::ActiveSupport::TimeWithZone.singleton_class do

data/lib/decentworks/date_support/configuration.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "date"
+require "active_support/core_ext/module/delegation"
+
+module Decentworks
+  module DateSupport
+    class << self
+      def configure
+        @configuration ||= Configuration.new
+
+        yield(@configuration) if block_given?
+      end
+
+      def configuration
+        raise "Initialization has not been performed." if @configuration.nil?
+
+        @configuration
+      end
+
+      # 開始月名
+      delegate :beginning_of_first_quarter, to: :configuration
+
+      # 開始月数
+      delegate :beginning_of_first_quarter_month, to: :configuration
+
+      # 開始月の初期
+      def reset_configuration!
+        @configuration = nil
+      end
+
+      # 1月始まりとの開始月のずれ
+      delegate :first_quarter_month_offset, to: :configuration
+    end
+
+    class Configuration
+      # { january: 1, february: 2, ... december: 12 }
+      MONTHS = ::Date::MONTHNAMES
+               .each_with_index
+               .filter_map { |name, index| [name.downcase.to_sym, index] if name }
+               .to_h
+               .freeze
+
+      # 開始月の初期値（1月）
+      DEFAULT = :january
+
+      # 開始月
+      attr_reader :beginning_of_first_quarter
+
+      def initialize
+        @beginning_of_first_quarter = DEFAULT
+      end
+
+      def beginning_of_first_quarter=(month_name)
+        unless MONTHS.key?(month_name)
+          raise ::ArgumentError,
+                "beginning_of_first_quarter must be one of #{MONTHS.keys.inspect} (got #{month_name.inspect})"
+        end
+
+        @beginning_of_first_quarter = month_name
+      end
+
+      # 開始月数
+      def beginning_of_first_quarter_month = MONTHS.fetch(beginning_of_first_quarter)
+
+      # 1月始まりとの開始月のずれ
+      def first_quarter_month_offset
+        beginning_of_first_quarter_month - 1
+      end
+    end
+  end
+end