holiday_japan 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2105a9ddbfa397b697e57d61ddf5e22e8a6df3b2
-  data.tar.gz: 0dd34389a1f2f52e5c9fb4fe9a621f2f0aef16c2
+  metadata.gz: 7235f35a33ef41c4c321e5b1c6474b366dc52523
+  data.tar.gz: cd51c67628ce7ea70154a706ee263a8cee09f036
 SHA512:
-  metadata.gz: adaa5333ad5a9160cc9485321bbe9c5a56b3915d1fa82c488f34c35147565bef4e7581fb9f9d12a5d18cb6115d98ac7c196c3d96bca37e10c9d3516f73244bbb
-  data.tar.gz: 99e7df5fedc7139e0b21f9ebc51f00c454d5503602d2184a9bd7c734d27267bc2b214317e702cc692912b7d5d462a1691e111395049264eb87fa05834e1d66f8
+  metadata.gz: 794471013ddaa254b4198254655b931af967262bd89cab8c72d7578f6d06acbac4cda960e64462665635fe5e76848a16acec09f99a426e6fac13e53245ac629b
+  data.tar.gz: 02ac427351b1556ec49ed032e392be247819a38d3176b0ef16d7c5b024ff17936557007b61d422f06bc2342dfd514e20d697b64ff6b9ed4ddc01610c21913db8

data/README.md

@@ -1,84 +1,94 @@
 # 日本の祝日判定Rubyプログラム
 
 ## 特徴
+* 1948年7月20日以降の日本の国民の祝日および振替などの休日を計算して判定する
+
 (date2 の holiday.rb と比較して)
 * 祝日をキャッシュすることにより、大量の日付について祝日判定する場合でも高速に動作
 * 祝日名を返すことが可能
 * 祝日のルールをテーブルで持つことにより、法改正による祝日変更への対応が容易
 
-## Rubyスクリプトでの使い方
-
-* 準備
+## インストール
 
  * RubyGems によるインストール
 
             gem install holiday_japan
 
  * または、[holiday_japan.rb](https://github.com/masa16/holiday_japan/blob/master/lib/holiday_japan.rb)
-   のファイルを ruby のライブラリパスに置く
- * 自分のスクリプトの初めに次のように書いて、 holiday_japan.rb をロードする
+   のスクリプトファイルを ruby のライブラリパスに置く
 
-            require 'holiday_japan'
+## プログラムの読み込み
+ * 自分のスクリプトの先頭に次のように書いて、 holiday_japan.rb をロードする
 
-* Dateクラスのオブジェクトによる祝日判定
+            require 'holiday_japan'
 
-        if HolidayJapan.check(Date.today)
-          ...
+## module HolidayJapan
+#### モジュール関数
 
-  または
+* `check(date)` ― Dateクラスのオブジェクトによる祝日判定
 
-        if Date.today.national_holiday?
+        if HolidayJapan.check(Date.today)
           ...
 
-* 日付が祝日の場合は祝日名を返し、祝日でなければ nil を返す。
+* `name(date)` ― 日付が祝日の場合は祝日名を返し、祝日でなければ nil を返す。
 
         name = HolidayJapan.name(Date.new(2007,3,22))
 
-* ある年について、 [日付, 祝日名] の配列を返す
+* `list_year(year)` ― ある年について、 [日付, 祝日名] のArrayを返す
 
         list = HolidayJapan.list_year(2007)
 
-* ある年の祝日一覧をプリント
+* `hash_year(year)` ― ある年について、 {日付=>祝日名} のHashを返す
+
+        list = HolidayJapan.hash_year(2007)
+
+* `between(from_date,to_date)` ― from_date から to_date までの祝日について、
+{日付=>祝日名}のHashを返す
+
+        hash = HolidayJapan.hash_between(Date.new(2014,7,1),Date.new(2015,6,30))
+
+* `print_year(year)` ― ある年の祝日一覧をプリント
 
         HolidayJapan.print_year(2007)
 
 ## コマンドラインから祝日一覧を表示
 
-	$ ruby holiday_japan.rb 2013
-	listing year 2013...
-	2013-01-01 Tue 元日
-	2013-01-14 Mon 成人の日
-	2013-02-11 Mon 建国記念の日
-	2013-03-20 Wed 春分の日
-	2013-04-29 Mon 昭和の日
-	2013-05-03 Fri 憲法記念日
-	2013-05-04 Sat みどりの日
-	2013-05-05 Sun こどもの日
-	2013-05-06 Mon 振替休日
-	2013-07-15 Mon 海の日
-	2013-09-16 Mon 敬老の日
-	2013-09-23 Mon 秋分の日
-	2013-10-14 Mon 体育の日
-	2013-11-03 Sun 文化の日
-	2013-11-04 Mon 振替休日
-	2013-11-23 Sat 勤労感謝の日
-	2013-12-23 Mon 天皇誕生日
+    $ ruby -r holiday_japan -e 'HolidayJapan.print_year 2016'
+    listing year 2016...
+    2016-01-01 Fri 元日
+    2016-01-11 Mon 成人の日
+    2016-02-11 Thu 建国記念の日
+    2016-03-20 Sun 春分の日
+    2016-03-21 Mon 振替休日
+    2016-04-29 Fri 昭和の日
+    2016-05-03 Tue 憲法記念日
+    2016-05-04 Wed みどりの日
+    2016-05-05 Thu こどもの日
+    2016-07-18 Mon 海の日
+    2016-08-11 Thu 山の日
+    2016-09-19 Mon 敬老の日
+    2016-09-22 Thu 秋分の日
+    2016-10-10 Mon 体育の日
+    2016-11-03 Thu 文化の日
+    2016-11-23 Wed 勤労感謝の日
+    2016-12-23 Fri 天皇誕生日
 
 ##  祝日データ
 
 * 1948年7月20日(祝日法発令) 以降の祝日に対応
-* 2015年の暦要項まで確認（法改正がない限り以降も有効）
+* 2016年の[暦要項](http://eco.mtk.nao.ac.jp/koyomi/yoko/)まで確認（法改正がない限り以降も有効）
 
 ## Author:
     Masahiro TANAKA
 
 ## Copyright:
-    (C) Copyright 2003-2013 by Masahiro TANAKA
+    (C) Copyright 2003-2015 by Masahiro TANAKA
     This program is free software under MIT license.
     See LICENSE.txt.
     NO WARRANTY.
 
 ## Version:
+    2015-04-11  ver 1.2  hash_year, between 関数追加
     2014-05-23  ver 1.1  「山の日」追加
     2012-12-23  ver 1.0  モジュール名を Holiday から HolidayJapan に変更
     2007-08-02  ver 0.9  リファクタリング

data/lib/holiday_japan.rb

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
-# (C) Copyright 2003-2013 by Masahiro TANAKA
+# (C) Copyright 2003-2015 by Masahiro TANAKA
 # This program is free software under MIT license.
 # NO WARRANTY.
 require "date"
 
 module HolidayJapan
 
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 
   WEEK1 = 1..7
   WEEK2 = 8..14
@@ -123,6 +123,30 @@ module HolidayJapan
     TABLE[year].sort_by{|x| x[0]}
   end
 
+  def hash_year(year)
+    TABLE[year] ||= create_table(year)
+  end
+
+  def between(from_date,to_date)
+    if from_date > to_date
+      raise ArgumentError, "to_date is earlier than from_date"
+    end
+    y1 = from_date.year
+    y2 = to_date.year
+    if y1 == y2
+      result = hash_year(y1).select{|d,n| d >= from_date && d <= to_date}
+    else
+      result = hash_year(y1).select{|d,n| d >= from_date}
+      y = y1 + 1
+      while y < y2
+        result.merge!(hash_year(y))
+        y += 1
+      end
+      hash_year(y).each{|d,n| result[d]=n if d <= to_date}
+    end
+    result
+  end
+
   def print_year(year)
     puts "listing year #{year}..."
     list_year(year).each do |y|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: holiday_japan
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Masahiro TANAKA
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-23 00:00:00.000000000 Z
+date: 2015-04-11 00:00:00.000000000 Z
 dependencies: []
 description: Calculate National Holidays of Japan
 email:
@@ -44,9 +44,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Calculate National Holidays of Japan
 test_files: []
-has_rdoc: