decentworks-date-support 0.1.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yutaka.mizomoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 YutakaMizomoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,54 @@
+# Decentworks::Date::Support - 日付機能拡張ライブラリ
+
+## 概要
+
+Railsの`Date`、`ActiveSupport::TimeWithZone`に対する機能拡張を行います。
+
+## 機能
+
+### 週関係
+
+- 週の始まりの曜日を指定しての日付・期間の取得
+
+### 月関係
+
+- Nヶ月前、Nヶ月後の日付の取得メソッドの追加
+- 暦月の日付・期間の取得メソッドの追加
+
+### 四半期関係
+
+- 第1四半期〜第4四半期の日付・期間の取得メソッドの追加
+
+### 上下期関係
+
+- 上期〜下期の日付・期間の取得メソッドの追加
+
+### その他
+
+- 満経過月数の計算
+
+## インストール
+
+```ruby
+gem 'decentworks-date-support'
+```
+
+## 使い方の例
+
+```ruby
+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)
+```
+
+```ruby
+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
+```

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/Steepfile

@@ -0,0 +1,43 @@
+# D = Steep::Diagnostic
+#
+# target :lib do
+#   signature "sig"
+#   ignore_signature "sig/test"
+#
+#   check "lib"                       # Directory name
+#   check "path/to/source.rb"         # File name
+#   check "app/models/**/*.rb"        # Glob
+#   # ignore "lib/templates/*.rb"
+#
+#   # library "pathname"              # Standard libraries
+#   # library "strong_json"           # Gems
+#
+#   # configure_code_diagnostics(D::Ruby.default)      # `default` diagnostics setting (applies by default)
+#   # configure_code_diagnostics(D::Ruby.strict)       # `strict` diagnostics setting
+#   # configure_code_diagnostics(D::Ruby.lenient)      # `lenient` diagnostics setting
+#   # configure_code_diagnostics(D::Ruby.silent)       # `silent` diagnostics setting
+#   # configure_code_diagnostics do |hash|             # You can setup everything yourself
+#   #   hash[D::Ruby::NoMethod] = :information
+#   # end
+# end
+
+# target :test do
+#   unreferenced!                     # Skip type checking the `lib` code when types in `test` target is changed
+#   signature "sig/test"              # Put RBS files for tests under `sig/test`
+#   check "test"                      # Type check Ruby scripts under `test`
+#
+#   configure_code_diagnostics(D::Ruby.lenient)      # Weak type checking for test code
+#
+#   # library "pathname"              # Standard libraries
+# end
+
+target :lib do
+  # 型検査をしたいrubyファイルが格納されているディレクトリ名
+  check "lib"
+
+  # 型定義を記述するRBSファイルが格納されているディレクトリ名
+  signature "sig"
+
+  # 取り込みたいライブラリ
+  # library "pathname"
+end

data/lib/decentworks/active_support/time_with_zone_support.rb

@@ -0,0 +1,327 @@
+# frozen_string_literal: true
+
+require "date"
+require "decentworks/date_support"
+
+module Decentworks
+  module ActiveSupport
+    module TimeWithZoneSupport
+      using ::Decentworks::DateSupport
+
+      refine ::ActiveSupport::TimeWithZone do
+        # #############################################################################################################
+        # 週関係
+        # #############################################################################################################
+
+        #
+        # 今週
+        #
+
+        # 現在の日付が属する週の始まりの日付
+        #
+        # @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
+
+        # 現在の日付が属する週の終わりの日付
+        #
+        # @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
+
+        # 今週の期間
+        #
+        # @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, end_of_month) # steep:ignore NoMethod
+
+        #
+        # 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 = to_date.beginning_of_january.beginning_of_day # steep:ignore NoMethod
+
+        # 1月の月末
+        def end_of_january = beginning_of_january.end_of_month.end_of_day
+
+        # 1月の期間
+        def all_january = ::Range.new(beginning_of_january, end_of_january)
+
+        # 2月の月初
+        def beginning_of_february = to_date.beginning_of_february.beginning_of_day # steep:ignore NoMethod
+
+        # 2月の月末
+        def end_of_february = beginning_of_february.end_of_month.end_of_day
+
+        # 2月の期間
+        def all_february = ::Range.new(beginning_of_february, end_of_february)
+
+        # 3月の月初
+        def beginning_of_march = to_date.beginning_of_march.beginning_of_day # steep:ignore NoMethod
+
+        # 3月の月末
+        def end_of_march = beginning_of_march.end_of_month.end_of_day
+
+        # 3月の期間
+        def all_march = ::Range.new(beginning_of_march, end_of_march)
+
+        # 4月の月初
+        def beginning_of_april = to_date.beginning_of_april.beginning_of_day # steep:ignore NoMethod
+
+        # 4月の月末
+        def end_of_april = beginning_of_april.end_of_month.end_of_day
+
+        # 4月の期間
+        def all_april = ::Range.new(beginning_of_april, end_of_april)
+
+        # 5月の月初
+        def beginning_of_may = to_date.beginning_of_may.beginning_of_day # steep:ignore NoMethod
+
+        # 5月の月末
+        def end_of_may = beginning_of_may.end_of_month.end_of_day
+
+        # 5月の期間
+        def all_may = ::Range.new(beginning_of_may, end_of_may)
+
+        # 6月の月初
+        def beginning_of_june = to_date.beginning_of_june.beginning_of_day # steep:ignore NoMethod
+
+        # 6月の月末
+        def end_of_june = beginning_of_june.end_of_month.end_of_day
+
+        # 6月の期間
+        def all_june = ::Range.new(beginning_of_june, end_of_june)
+
+        # 7月の月初
+        def beginning_of_july = to_date.beginning_of_july.beginning_of_day # steep:ignore NoMethod
+
+        # 7月の月末
+        def end_of_july = beginning_of_july.end_of_month.end_of_day
+
+        # 7月の期間
+        def all_july = ::Range.new(beginning_of_july, end_of_july)
+
+        # 8月の月初
+        def beginning_of_august = to_date.beginning_of_august.beginning_of_day # steep:ignore NoMethod
+
+        # 8月の月末
+        def end_of_august = beginning_of_august.end_of_month.end_of_day
+
+        # 8月の期間
+        def all_august = ::Range.new(beginning_of_august, end_of_august)
+
+        # 9月の月初
+        def beginning_of_september = to_date.beginning_of_september.beginning_of_day # steep:ignore NoMethod
+
+        # 9月の月末
+        def end_of_september = beginning_of_september.end_of_month.end_of_day
+
+        # 9月の期間
+        def all_september = ::Range.new(beginning_of_september, end_of_september)
+
+        # 10月の月初
+        def beginning_of_october = to_date.beginning_of_october.beginning_of_day # steep:ignore NoMethod
+
+        # 10月の月末
+        def end_of_october = beginning_of_october.end_of_month.end_of_day
+
+        # 10月の期間
+        def all_october = ::Range.new(beginning_of_october, end_of_october)
+
+        # 11月の月初
+        def beginning_of_november = to_date.beginning_of_november.beginning_of_day # steep:ignore NoMethod
+
+        # 11月の月末
+        def end_of_november = beginning_of_november.end_of_month.end_of_day
+
+        # 11月の期間
+        def all_november = ::Range.new(beginning_of_november, end_of_november)
+
+        # 12月の月初
+        def beginning_of_december = to_date.beginning_of_december.beginning_of_day # steep:ignore NoMethod
+
+        # 12月の月末
+        def end_of_december = beginning_of_december.end_of_month.end_of_day
+
+        # 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 ::ActiveSupport::TimeWithZone.singleton_class do
+        # #############################################################################################################
+        # 満経過月数
+        # #############################################################################################################
+
+        # 満経過月数
+        # steep:ignore:start
+        def whole_months_elapsed(from:, to:)
+          ::Date.whole_months_elapsed(
+            from: from.to_date,
+            to: to.to_date
+          )
+        end
+        # steep:ignore:end
+      end
+    end
+  end
+end

data/lib/decentworks/date/support/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Decentworks
+  module Date
+    module Support
+      VERSION = "0.1.0"
+    end
+  end
+end