trading_day_jp 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cea525fccd73e7a559f0d62a23438e6b19be4971
-  data.tar.gz: 27d2bef15b429b3ec0451cf005be25cacd962d3f
+  metadata.gz: 9205b753b14e42d931a01a8d90b46c9cd695e254
+  data.tar.gz: 94fa5f305d24b40632138dab2e3d51b859d4cadf
 SHA512:
-  metadata.gz: 82a5163801b5040a6749e4b6f32d586882deebf7ed5fbd45358b24db10dc5220dba4a0a246a41fc402e7f1aaaa0dad0c245e71e8b93edbda4621a3c6ff002379
-  data.tar.gz: ea83499e129fb0040cad615acce03c315a50a7dc085d3fbf8bd9f6917c9317df8581142ee8057b09810b94ff0a97451b8607e1b2932a6c223052cdc87b4b2bab
+  metadata.gz: 84d895e9523bf4112b9af8d6163375b25567a65e01017c4135ed2f82a33703e8268d31c9f6209f316dd64217b229108d9fdf868ac997469de6ee208e8d561d63
+  data.tar.gz: d2d49ab97d15ab8a3a10ced316fddc703a393cb73fbc3584dcbb89a0019e6a141450510722eb05d7890c8772fc2c823f1fd8228e07ffd578510ea7b140252794

data/README.md

@@ -24,19 +24,36 @@ Or install it yourself as:
 大発会〜大納会のうち、休日及び祝日でない日が該当します。
 
 ``` ruby
+# 2014年12月30日は大納会
 date = Date.new(2014, 12, 30)
 
 date.trading_day_jp? # => true
 TradingDayJp.open?(date) # => true
 
+# 2014年12月31日は取引日でない
 date = Date.new(2014, 12, 31)
 
 date.trading_day_jp? # => false
 TradingDayJp.open?(date) # => false
 
+# 2014年9月23日は秋分の日
 start = Date.new(2014, 9, 22)
 last = Date.new(2014, 9, 26)
-TradingDayJp.between(start, last) # => [<Date: 2014-09-22>, <Date: 2014-09-24>, <Date: 2014-09-25>, <Date: 2014-09-26>]
+
+TradingDayJp.between(start, last)
+  # => [<Date: 2014-09-22>, <Date: 2014-09-24>, <Date: 2014-09-25>, <Date: 2014-09-26>]
+
+# 2014年6月2日はその月の最初の取引日
+date = Date.new(2014, 6, 10)
+
+TradingDayJp.beginning_of_month(date) # => <Date: 2014-06-02>
+
+# 2014年8月29日はその月の最後の取引日
+date = Date.new(2014, 8, 10)
+
+TradingDayJp.end_of_month(date) # => <Date: 2014-08-29>
+
+# 他にもメソッドあります
 ```
 
 ## Contributing

data/lib/trading_day_jp.rb

@@ -2,14 +2,109 @@ require "trading_day_jp/date"
 
 module TradingDayJp
 
-  def self.open?(date)
-    date.trading_day_jp?
-  end
+  class << self
 
-  def self.between(start, last)
-    (start..last).select do |date|
+    def open?(date)
       date.trading_day_jp?
     end
+
+    def next(date)
+      loop do
+        date = date + 1
+
+        return date if date.trading_day_jp?
+      end
+    end
+
+    def prev(date)
+      loop do
+        date = date - 1
+
+        return date if date.trading_day_jp?
+      end
+    end
+
+    def between(start, last)
+      (start..last).select do |date|
+        date.trading_day_jp?
+      end
+    end
+
+    def beginning_of_month(date)
+      date = Date.new(date.year, date.month)
+
+      loop do
+        return date if date.trading_day_jp?
+
+        date = date + 1
+      end
+    end
+
+    def end_of_month(date)
+      date = Date.new(date.year, date.month).next_month - 1
+
+      loop do
+        return date if date.trading_day_jp?
+
+        date = date - 1
+      end
+    end
+
+    def beginning_of_month?(date)
+      date == beginning_of_month(date)
+    end
+
+    def end_of_month?(date)
+      date == end_of_month(date)
+    end
+
+    def beginning_of_quarter(date)
+      if date.month <= 3
+        beginning_of_month Date.new(date.year, 1)
+      elsif date.month <= 6
+        beginning_of_month Date.new(date.year, 4)
+      elsif date.month <= 9
+        beginning_of_month Date.new(date.year, 7)
+      else
+        beginning_of_month Date.new(date.year, 10)
+      end
+    end
+
+    def end_of_quarter(date)
+      if date.month <= 3
+        end_of_month Date.new(date.year, 3)
+      elsif date.month <= 6
+        end_of_month Date.new(date.year, 6)
+      elsif date.month <= 9
+        end_of_month Date.new(date.year, 9)
+      else
+        end_of_month Date.new(date.year, 12)
+      end
+    end
+
+    def beginning_of_quarter?(date)
+      date == beginning_of_quarter(date)
+    end
+
+    def end_of_quarter?(date)
+      date == end_of_quarter(date)
+    end
+
+    def beginning_of_year(date)
+      self.next(Date.new date.year)
+    end
+
+    def end_of_year(date)
+      prev beginning_of_year(Date.new(date.year + 1))
+    end
+
+    def beginning_of_year?(date)
+      date == beginning_of_year(date)
+    end
+
+    def end_of_year?(date)
+      date == end_of_year(date)
+    end
   end
 
 end

data/lib/trading_day_jp/version.rb

@@ -1,3 +1,3 @@
 module TradingDayJp
-  VERSION = "1.0.2"
+  VERSION = "1.1.0"
 end

data/spec/trading_day_jp_spec.rb

@@ -12,6 +12,30 @@ describe TradingDayJp do
     end
   end
 
+  describe '.next' do
+    it '次の取引日を取得する' do
+      date = Date.new 2014, 2, 10
+      next_date = date + 1
+      next_trading_day = TradingDayJp.next date
+
+      expect(next_date.trading_day_jp?).to eq false
+      expect(next_trading_day.trading_day_jp?).to eq true
+      expect(next_trading_day).to eq Date.new(2014, 2, 12)
+    end
+  end
+
+  describe '.prev' do
+    it '前の取引日を取得する' do
+      date = Date.new 2014, 2, 12
+      prev_date = date - 1
+      prev_trading_day = TradingDayJp.prev date
+
+      expect(prev_date.trading_day_jp?).to eq false
+      expect(prev_trading_day.trading_day_jp?).to eq true
+      expect(prev_trading_day).to eq Date.new(2014, 2, 10)
+    end
+  end
+
   describe '.between' do
     it '取引日でない日を含まない' do
       start = Date.new 2014, 9, 22
@@ -25,4 +49,168 @@ describe TradingDayJp do
     end
   end
 
+  describe '.beginning_of_month' do
+    it 'その月の最初の取引日を取得する' do
+      date = Date.new 2014, 6, 10
+
+      expect(TradingDayJp.beginning_of_month date).to eq Date.new(2014, 6, 2)
+    end
+
+    context '月初' do
+      it do
+        date = Date.new 2014, 5, 1
+
+        expect(TradingDayJp.beginning_of_month date).to eq date
+      end
+    end
+  end
+
+  describe '.end_of_month' do
+    it 'その月の最後の取引日を取得する' do
+      date = Date.new 2014, 8, 10
+
+      expect(TradingDayJp.end_of_month date).to eq Date.new(2014, 8, 29)
+    end
+
+    context '月末' do
+      it do
+        date = Date.new 2014, 6, 30
+
+        expect(TradingDayJp.end_of_month date).to eq date
+      end
+    end
+  end
+
+  describe '.beginning_of_month?' do
+    it do
+      date = Date.new 2014, 6, 2
+
+      expect(TradingDayJp.beginning_of_month? date).to eq true
+    end
+  end
+
+  describe '.end_of_month?' do
+    it do
+      date = Date.new 2014, 8, 29
+
+      expect(TradingDayJp.end_of_month? date).to eq true
+    end
+  end
+
+  describe '.beginning_of_quarter' do
+    context '3月' do
+      it do
+        date = Date.new 2014, 3, 1
+
+        expect(TradingDayJp.beginning_of_quarter date).to eq Date.new(2014, 1, 6)
+      end
+    end
+
+    context '6月' do
+      it do
+        date = Date.new 2014, 6, 1
+
+        expect(TradingDayJp.beginning_of_quarter date).to eq Date.new(2014, 4, 1)
+      end
+    end
+
+    context '9月' do
+      it do
+        date = Date.new 2014, 9, 1
+
+        expect(TradingDayJp.beginning_of_quarter date).to eq Date.new(2014, 7, 1)
+      end
+    end
+
+    context '12月' do
+      it do
+        date = Date.new 2014, 12, 1
+
+        expect(TradingDayJp.beginning_of_quarter date).to eq Date.new(2014, 10, 1)
+      end
+    end
+  end
+
+  describe '.end_of_quarter' do
+    context '1月' do
+      it do
+        date = Date.new 2014, 1, 1
+
+        expect(TradingDayJp.end_of_quarter date).to eq Date.new(2014, 3, 31)
+      end
+    end
+
+    context '4月' do
+      it do
+        date = Date.new 2014, 4, 1
+
+        expect(TradingDayJp.end_of_quarter date).to eq Date.new(2014, 6, 30)
+      end
+    end
+
+    context '7月' do
+      it do
+        date = Date.new 2014, 7, 1
+
+        expect(TradingDayJp.end_of_quarter date).to eq Date.new(2014, 9, 30)
+      end
+    end
+
+    context '10月' do
+      it do
+        date = Date.new 2014, 10, 1
+
+        expect(TradingDayJp.end_of_quarter date).to eq Date.new(2014, 12, 30)
+      end
+    end
+  end
+
+  describe '.beginning_of_quarter?' do
+    it do
+      date = Date.new 2014, 4, 1
+
+      expect(TradingDayJp.beginning_of_quarter? date).to eq true
+    end
+  end
+
+  describe '.end_of_quarter?' do
+    it do
+      date = Date.new 2014, 3, 31
+
+      expect(TradingDayJp.end_of_quarter? date).to eq true
+    end
+  end
+
+  describe '.beginning_of_year' do
+    it 'その年の最初の取引日を取得する' do
+      date = Date.new 2014, 6, 10
+
+      expect(TradingDayJp.beginning_of_year date).to eq Date.new(2014, 1, 6)
+    end
+  end
+
+  describe '.end_of_year' do
+    it 'その年の最後の取引日を取得する' do
+      date = Date.new 2014, 6, 10
+
+      expect(TradingDayJp.end_of_year date).to eq Date.new(2014, 12, 30)
+    end
+  end
+
+  describe '.beginning_of_year?' do
+    it do
+      date = Date.new 2014, 1, 6
+
+      expect(TradingDayJp.beginning_of_year? date).to eq true
+    end
+  end
+
+  describe '.end_of_year?' do
+    it do
+      date = Date.new 2014, 12, 30
+
+      expect(TradingDayJp.end_of_year? date).to eq true
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trading_day_jp
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Takehiko Shinkura
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-19 00:00:00.000000000 Z
+date: 2014-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler