duration-range 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31ca768c2bf4dc12f6de5f78ff2efcd8a08962c3b0c106583979c138ba688f7b
-  data.tar.gz: 34a075181c3f19e13bc1148481d60540841c0df5212f47fc2da94f99b01a1cc9
+  metadata.gz: 2906de236492e14acd76597c419e63417d7caad207afecd8ddcbb0818614055a
+  data.tar.gz: 610a910d62c6b9d3eedc64445752b9bebe1526da96c40f38c02ebfa4ff574db8
 SHA512:
-  metadata.gz: 06daafdabccf9ff4473041e1b072a48dd12fef80b22d3639625da2cd7270ed693c12308eec6cbb085e7336d8eaa0ec0b9a739775f277584b711b92ae347ba1e6
-  data.tar.gz: c2998d5d3496143fb23655f0a552a8b6d1e97f547f51a294056b5513268c80e8f732c0e298a97a29e5a52c952f2673c105445d59b977ba5bfd372e80d81b38fb
+  metadata.gz: 0a7c3a32aad450e98d5ecf58eab08b085fea3f41df8c55b675a13f70f5bfbf1565d40e0a7d7efe885a9aa4b8c1dfb2fc851d65e726e0ecfe8575662344c5bfb7
+  data.tar.gz: 7357529ea96eb43b21cc96bd620a96ede03c06408b49fcce07cc9f1c685f6e3abfd398015d9bdc4ae2e3e82218c32d357595ee7e8628fa88b325c35c3eb0947f

data/README.md

@@ -2,6 +2,34 @@
 
 duration range data generator
 
+## Features
+
+generate Array / Hash of Date / Time
+
+e.g.
+
+```
+{:begin=>Mon, 19 Apr 2021, :end=>Sun, 25 Apr 2021} # week as Hash of Date
+[Mon, 19 Apr 2021, Tue, 20 Apr 2021, ... Sun, 25 Apr 2021] # week as Array of Date
+{:begin=>2021-04-01 00:00:00 UTC, :end=>2021-05-01 00:00:00 UTC} # month as Hash of Time
+```
+
+available classes:
+
+ * DurationRange::Date ( default type Array )
+ * DurationRange::Time ( default type Hash )
+
+available methods:
+
+ * this_week
+ * last_week
+ * next_week
+ * this_month
+ * last_month
+ * next_month
+ * month
+ * months
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -31,6 +59,12 @@ DurationRange::Date.new.last_month(as: :hash)
 
 DurationRange::Time.new.last_month
 # => {:begin=>2021-04-01 00:00:00 UTC, :end=>2021-05-01 00:00:00 UTC}
+
+DurationRange::Time.new.month('2021-04')
+# => {:begin=>2021-04-01 00:00:00 UTC, :end=>2021-05-01 00:00:00 UTC}
+
+DurationRange::Date.new.months('2021-04', '2021-06')
+# => [Thu, 01 Apr 2021, Fri, 02 Apr 2021, ... Wed, 30 Jun 2021]
 ```
 
 ## Development

data/lib/duration_range/common_functions.rb

@@ -31,12 +31,46 @@ module DurationRange
       end
     end
 
+    #
+    # @param month [String]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    def month_as_date(month, as:)
+      this_month_as_date(as: as, reference_date: ::Date.parse(month + '-01'))
+    end
+
+    #
+    # @param months [Array]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    # :reek:NilCheck :reek:TooMenyStatements
+    def months_as_date(*months, as:)
+      min = nil
+      max = nil
+      months.each { |mon|
+        dates = month_as_date(mon, as: :hash)
+        begin_date = dates[:begin]
+        end_date = dates[:end]
+
+        if min.nil? || begin_date < min
+          min = begin_date
+        end
+        if max.nil? || max < end_date
+          max = end_date
+        end
+      }
+
+      tidy_with_date(as: as, begin_date: min, end_date: max)
+    end
+
     #
     # @param as [Symbol]
     # @param reference_date [Date]
     # @return [Object]
     #
-    def this_month(as:, reference_date: today)
+    def this_month_as_date(as:, reference_date: today)
       begin_date = reference_date.at_beginning_of_month
       end_date = reference_date.at_end_of_month
 

data/lib/duration_range/date.rb

@@ -6,13 +6,35 @@ module DurationRange
   class Date
     include DurationRange::CommonFunctions
 
+    #
+    # generate specific month duration (e.g. 2021-04)
+    #
+    # @param month [String]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    def month(month, as: :array)
+      month_as_date(month, as: as)
+    end
+
+    #
+    # longest duration from multiple months
+    #
+    # @param months [Array]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    def months(*months, as: :array)
+      months_as_date(*months, as: as)
+    end
+
     #
     # @param as [Symbol]
     # @param reference_date [Date]
     # @return [Object]
     #
     def this_month(as: :array, reference_date: today)
-      super(as: as, reference_date: reference_date)
+      this_month_as_date(as: as, reference_date: reference_date)
     end
 
     #

data/lib/duration_range/time.rb

@@ -45,13 +45,35 @@ module DurationRange
       with_localtime ? date.to_time : date.to_time(:utc)
     end
 
+    #
+    # @param month [String]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    def month(month, as: :hash)
+      dates = month_as_date(month, as: :hash)
+
+      tidy_with_time(as: as, begin_date: dates[:begin], end_date: dates[:end] + 1)
+    end
+
+    #
+    # @param months [Array]
+    # @param as [Symbol]
+    # @return [Object]
+    #
+    def months(*months, as: :hash)
+      dates = months_as_date(*months, as: :hash)
+
+      tidy_with_time(as: as, begin_date: dates[:begin], end_date: dates[:end] + 1)
+    end
+
     #
     # @param as [Symbol]
     # @param reference_date [Date]
     # @return [Object]
     #
     def this_month(as: :hash, reference_date: today)
-      dates = super(as: :hash, reference_date: reference_date)
+      dates = this_month_as_date(as: :hash, reference_date: reference_date)
 
       tidy_with_time(as: as, begin_date: dates[:begin], end_date: dates[:end] + 1)
     end

data/lib/duration_range/version.rb

@@ -1,3 +1,3 @@
 module DurationRange
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: duration-range
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - wtnabe