activesupport-fiscal_dates 1.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: eabba22bd3da26b1255e5b036c01b549fa93eb97
+  data.tar.gz: d0cca4cff92a2715eaba5c78190ccf4e5a8883fc
+SHA512:
+  metadata.gz: c6b566649829d5be47bba83e6c1ea5f698ab66a25643e10d865f91b0ddab4e4a1898e6e2f6c78a76268af89aadaa3b0896d5993ea43e063adfc15a212bb32f62
+  data.tar.gz: de95233c91b1d1332a5ef25387173918d93e267e8ed48a76106b4335b0dbd3e6304fb7408404e52e6c460f098d618141bc98eb259976e965aca9488674da5b7e

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--colour --fail-fast --format documentation

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in activesupport-fiscal_dates.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2016 Kinesis Pty Ltd
+
+MIT License
+
+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,124 @@
+[![CircleCI](https://circleci.com/gh/kinesisptyltd/activesupport-fiscal_dates.svg?style=svg)](https://circleci.com/gh/kinesisptyltd/activesupport-fiscal_dates)
+
+# Activesupport::FiscalDates
+
+Activesupport::FiscalDates adds some useful methods for fiscal year calculations to the `Date` class. Currently it only supports the Australian fiscal year period (July to June).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'activesupport-fiscal_dates'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install activesupport-fiscal_dates
+
+## Usage
+
+### Getting Fiscal Years and Ranges
+
+Use `.current_fiscal_year` to get the current fiscal year as an integer. Returns `2015` for FY 2014-15.
+
+```ruby
+# Today is September 10th, 2014
+
+Date.current_fiscal_year
+# => 2015
+```
+
+Or get the fiscal year range with `.current_fiscal_year_range`.
+
+```ruby
+# Today is September 10th, 2014
+
+Date.current_fiscal_year_range
+# => Tue, 01 Jul 2014..Tue, 30 Jun 2015
+```
+
+Use `.fiscal_year_ranges_between` and `.calendar_year_ranges_between` to get an array of fiscal or calendar year ranges.
+
+```ruby
+start_date = Date.new(2012)
+end_date = Date.new(2014)
+
+Date.fiscal_year_ranges_between(start_date, end_date)
+
+# => [
+#     [0] Fri, 01 Jul 2011..Sat, 30 Jun 2012,
+#     [1] Sun, 01 Jul 2012..Sun, 30 Jun 2013,
+#     [2] Mon, 01 Jul 2013..Mon, 30 Jun 2014
+# ]
+
+Date.calendar_year_ranges_between(start_date, end_date)
+
+# => [
+#     [0] Sun, 01 Jan 2012..Mon, 31 Dec 2012,
+#     [1] Tue, 01 Jan 2013..Tue, 31 Dec 2013,
+#     [2] Wed, 01 Jan 2014..Wed, 31 Dec 2014
+# ]
+```
+
+Use `.fiscal_years_since` to create an array of arrays of the format `[label, value]` that's useful for `<select>` options. It includes the current fiscal year. The output style is set in `.fiscal_year_label`.
+
+```ruby
+Date.fiscal_years_since(2012)
+
+# => [
+#     [0] [
+#         [0] "2011-12",
+#         [1] "2012"
+#     ],
+#     [1] [
+#         [0] "2012-13",
+#         [1] "2013"
+#     ],
+#     [2] [
+#         [0] "2013-14",
+#         [1] "2014"
+#     ]
+#     [3] [
+#         [0] "2014-15",
+#         [1] "2015"
+#     ]
+# ]
+```
+
+### Instance methods
+
+Use `#fiscal_year` to get the specified date's fiscal year as an integer.
+
+```ruby
+Date.new(2014, 7).fiscal_year
+# => 2015
+```
+
+Use `#fiscal_year_first_day`, `#fiscal_year_last_day`, `#calendar_year_first_day` and `#calendar_year_last_day` to get those specific days.
+
+```ruby
+Date.new(2014, 1).fiscal_year_first_day
+# => Mon, 01 Jul 2013
+
+Date.new(2014, 1).fiscal_year_last_day
+# => Mon, 30 Jun 2014
+
+Date.new(2014, 1).calendar_year_first_day
+# => Wed, 01 Jan 2014
+
+Date.new(2014, 1).calendar_year_last_day
+# => Wed, 31 Dec 2014
+```
+
+And use `#fiscal_year_range` and `#calendar_year_range` to get the individual year as a range.
+
+```ruby
+Date.new(2014, 1).fiscal_year_range
+# => Mon, 01 Jul 2013..Mon, 30 Jun 2014
+
+Date.new(2014, 1).calendar_year_range
+# => Wed, 01 Jan 2014..Wed, 31 Dec 2014
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/activesupport-fiscal_dates.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'active_support/fiscal_dates/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "activesupport-fiscal_dates"
+  spec.version       = ActiveSupport::FiscalDates::VERSION
+  spec.authors       = ["Kinesis Pty Ltd"]
+  spec.email         = ["devs@kinesis.org"]
+  spec.summary       = %q{Adds fiscal date support}
+  spec.description   = %q{Adds fiscal date support to Date objects}
+  spec.homepage      = "https://github.com/kinesisptyltd/activesupport-fiscal_dates"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake", "~> 11"
+  spec.add_development_dependency "rspec", "~> 3.5"
+  spec.add_development_dependency "pry-byebug", "~> 3.4"
+
+  spec.add_dependency "activesupport", "~> 4.1", ">= 4.1.0"
+end

data/circle.yml

@@ -0,0 +1,3 @@
+machine:
+  ruby:
+    version: 2.3.1

data/lib/active_support/fiscal_dates/date.rb

@@ -0,0 +1,86 @@
+class Date
+  def self.current_fiscal_year
+    # Returns "2015" for FY 2014-15
+    today = Date.today
+    today.month < 7 ? today.year : today.year + 1
+  end
+
+  def self.current_fiscal_year_range
+    today = Date.today
+    if today.month < 7
+      Date.new(today.year - 1, 7)..Date.new(today.year, 6, 30)
+    else
+      Date.new(today.year, 7)..Date.new(today.year + 1, 6, 30)
+    end
+  end
+
+  def self.fiscal_year_ranges_between(start_date, end_date)
+    (start_date.fiscal_year_first_day.year..end_date.fiscal_year_first_day.year).map do |year|
+      Date.new(year, 7).fiscal_year_range
+    end
+  end
+
+  def self.calendar_year_ranges_between(start_date, end_date)
+    (start_date.year..end_date.year).map { |year| Date.new(year).calendar_year_range }
+  end
+
+  def self.fiscal_years_since(start_year)
+    # Includes the current fiscal year
+    # Output gets set in .fiscal_year_label
+    # Suitable for year select dropdowns in Corporate.
+
+    result = []
+    today = Date.today
+    current_year = today.year.to_i
+    month = today.month.to_i
+    end_year = month >= 7 ? current_year + 1 : current_year
+
+    (start_year..end_year).each do |year|
+      result << [fiscal_year_label(year), year.to_s]
+    end
+
+    result
+  end
+
+  def self.fiscal_year_label(year)
+    # Output example: [["2012-13", "2013"], ["2013-14", "2014"]]
+
+    "#{year - 1}-#{year.to_s[-2, 2]}"
+  end
+
+  def fiscal_year
+    self.month < 7 ? self.year : self.year + 1
+  end
+
+  def fiscal_year_first_day
+    if self.month < 7
+      Date.new(self.year - 1, 7)
+    else
+      Date.new(self.year, 7)
+    end
+  end
+
+  def fiscal_year_last_day
+    if self.month < 7
+      Date.new(self.year, 6).end_of_month
+    else
+      Date.new(self.year + 1, 6).end_of_month
+    end
+  end
+
+  def fiscal_year_range
+    fiscal_year_first_day..fiscal_year_last_day
+  end
+
+  def calendar_year_first_day
+    Date.new(self.year)
+  end
+
+  def calendar_year_last_day
+    Date.new(self.year).end_of_year
+  end
+
+  def calendar_year_range
+    calendar_year_first_day..calendar_year_last_day
+  end
+end

data/lib/active_support/fiscal_dates/version.rb

@@ -0,0 +1,5 @@
+module ActiveSupport
+  module FiscalDates
+    VERSION = "1.0.3"
+  end
+end

data/lib/activesupport-fiscal_dates.rb

@@ -0,0 +1,4 @@
+require "active_support"
+require "active_support/core_ext"
+require "active_support/fiscal_dates/version"
+require "active_support/fiscal_dates/date"

data/spec/lib/active_support/fiscal_dates/date_spec.rb

@@ -0,0 +1,205 @@
+require "spec_helper"
+require "pry"
+require "pry-byebug"
+
+describe Date do
+  describe ".current_fiscal_year" do
+    context "before july" do
+      before { allow(Date).to receive(:today) { Date.new(2013, 1) } }
+
+      it "returns the correct fiscal year" do
+        expect(Date.current_fiscal_year).to eq 2013
+      end
+    end
+
+    context "after july" do
+      before { allow(Date).to receive(:today) { Date.new(2013, 8) } }
+
+      it "returns the correct fiscal year" do
+        expect(Date.current_fiscal_year).to eq 2014
+      end
+    end
+  end
+
+  describe ".current_fiscal_year_range" do
+    context "before july" do
+      before { allow(Date).to receive(:today) { Date.new(2013, 1) } }
+
+      it "returns the correct fiscal year range" do
+        expect(Date.current_fiscal_year_range).to eq Date.new(2012, 7)..Date.new(2013, 6, 30)
+      end
+    end
+
+    context "after july" do
+      before { allow(Date).to receive(:today) { Date.new(2013, 8) } }
+
+      it "returns the correct fiscal year" do
+        expect(Date.current_fiscal_year_range).to eq Date.new(2013, 7)..Date.new(2014, 6, 30)
+      end
+    end
+  end
+
+  describe ".fiscal_year_ranges_between" do
+    let(:start_date) { Date.new(2012, 1) }
+    let(:end_date) { Date.new(2014, 8) }
+
+    it "returns an array" do
+      expect(Date.fiscal_year_ranges_between(start_date, end_date)).to be_an Array
+    end
+
+    it "returns the correct number of elements" do
+      expect(Date.fiscal_year_ranges_between(start_date, end_date).length).to eq 4
+    end
+
+    it "contains ranges" do
+      expect(Date.fiscal_year_ranges_between(start_date, end_date).first).to be_a Range
+    end
+
+    it "contains ranges with the correct dates" do
+      expect(Date.fiscal_year_ranges_between(start_date, end_date).first).to eq Date.new(2011, 7)..Date.new(2012, 6 ,30)
+    end
+  end
+
+  describe ".calendar_year_ranges_between" do
+    let(:start_date) { Date.new(2012, 1) }
+    let(:end_date) { Date.new(2014, 8) }
+
+    it "returns an array" do
+      expect(Date.calendar_year_ranges_between(start_date, end_date)).to be_an Array
+    end
+
+    it "returns the correct number of elements" do
+      expect(Date.calendar_year_ranges_between(start_date, end_date).length).to eq 3
+    end
+
+    it "contains ranges" do
+      expect(Date.calendar_year_ranges_between(start_date, end_date).first).to be_a Range
+    end
+
+    it "contains ranges with the correct dates" do
+      expect(Date.calendar_year_ranges_between(start_date, end_date).first).to eq Date.new(2012, 1)..Date.new(2012, 12, 31)
+    end
+  end
+
+  describe ".fiscal_years_since" do
+    let(:start_year) { 2012 }
+
+    before { allow(Date).to receive(:today) { Date.new(2014, 1) } }
+
+    it "returns an array" do
+      expect(Date.fiscal_years_since(start_year)).to be_an Array
+    end
+
+    it "contains the right number of years" do
+      expect(Date.fiscal_years_since(start_year).length).to eq 3
+    end
+  end
+
+  describe ".fiscal_year_label" do
+    context "year is 2008" do
+      it "correctly formats the years" do
+        expect(Date.fiscal_year_label(2008)).to eq "2007-08"
+      end
+    end
+
+    context "year is 2011" do
+      it "correctly formats the years" do
+        expect(Date.fiscal_year_label(2011)).to eq "2010-11"
+      end
+    end
+  end
+
+  describe "#fiscal_year" do
+    context "before july" do
+      let(:date) { Date.new(2013, 01) }
+
+      it "returns the correct fiscal year" do
+        expect(date.fiscal_year).to eq date.year
+      end
+    end
+
+    context "after july" do
+      let(:date) { Date.new(2013, 8) }
+
+      it "returns the correct fiscal year" do
+        expect(date.fiscal_year).to eq date.year + 1
+      end
+    end
+  end
+
+  describe "#fiscal_year_first_day" do
+    context "before july" do
+      let(:date) { Date.new(2013, 01) }
+
+      it "returns the correct date" do
+        expect(date.fiscal_year_first_day).to eq Date.new(2012, 7)
+      end
+    end
+
+    context "after july" do
+      let(:date) { Date.new(2013, 8) }
+
+      it "returns the correct date" do
+        expect(date.fiscal_year_first_day).to eq Date.new(2013, 7)
+      end
+    end
+  end
+
+  describe "#fiscal_year_last_day" do
+    context "before july" do
+      let(:date) { Date.new(2013, 01) }
+
+      it "returns the correct date" do
+        expect(date.fiscal_year_last_day).to eq Date.new(2013, 6, 30)
+      end
+    end
+
+    context "after july" do
+      let(:date) { Date.new(2013, 8) }
+
+      it "returns the correct date" do
+        expect(date.fiscal_year_last_day).to eq Date.new(2014, 6, 30)
+      end
+    end
+  end
+
+  describe "#fiscal_year_range" do
+    let(:date) { Date.new(2013, 01) }
+
+    it "returns a range" do
+      expect(date.fiscal_year_range).to be_a Range
+    end
+
+    it "returns the correct dates" do
+      expect(date.fiscal_year_range).to eq Date.new(2012, 7)..Date.new(2013, 6, 30)
+    end
+  end
+
+  describe "#calendar_year_first_day" do
+    let(:date) { Date.new(2013, 8) }
+
+    it "returns the correct date" do
+      expect(date.calendar_year_first_day).to eq Date.new(2013, 1, 1)
+    end
+  end
+
+  describe "#calendar_year_last_day" do
+    let(:date) { Date.new(2013, 8) }
+
+    it "returns the correct date" do
+      expect(date.calendar_year_last_day).to eq Date.new(2013, 12, 31)
+    end
+  end
+
+  describe "#calendar_year_range" do
+    let(:date) { Date.new(2013, 8) }
+
+    it "returns a range" do
+      expect(date.calendar_year_range).to be_a Range
+    end
+
+    it "returns the correct dates" do
+      expect(date.calendar_year_range).to eq Date.new(2013, 1)..Date.new(2013, 12, 31)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require "activesupport-fiscal_dates"

data/year.rb

@@ -0,0 +1,285 @@
+class Year
+  NUMBER_OF_WEEKDAYS = 250
+  NUMBER_OF_SATURDAYS = 52
+  NUMBER_OF_SUNDAYS = 51
+  NUMBER_OF_PUBLIC_HOLIDAYS = 12
+
+  # TODO loookup public holidays by region and year.
+
+  START_YEAR = 2003
+
+  # Returns an array of [month, year] which represents a financial reporting
+  # year. month and year are numerical
+  def self.financial_months(starting_year)
+    result = []
+    7.upto(12) {|n| result << [n, starting_year]}
+    1.upto(6) {|n| result << [n, starting_year + 1]}
+    result
+  end
+
+  # Returns true if today's date is past the end of the given financial year.
+  def self.incomplete_financial_year(year)
+    Date.today < financial_year_end_date(year)
+  end
+
+  def self.financial_months_menu_options(starting_year)
+    result = ActiveSupport::OrderedHash.new
+    7.upto(12) {|n| result["#{Date::MONTHNAMES[n]} #{starting_year}"] = "#{n},#{starting_year}"}
+    1.upto(6) {|n| result["#{Date::MONTHNAMES[n]} #{starting_year + 1}"] = "#{n},#{starting_year + 1}"}
+    result
+  end
+
+  def self.financial_months_menu_values(starting_year)
+    result = []
+    7.upto(12) {|n| result << "#{n},#{starting_year}"}
+    1.upto(6) {|n| result << "#{n},#{starting_year + 1}"}
+    result
+  end
+
+  def self.financial_months_menu_labels(starting_year)
+    result = []
+    7.upto(12) {|n| result << "#{n} #{starting_year}"}
+    1.upto(6) {|n| result << "#{n} #{starting_year + 1}"}
+    result
+  end
+
+  # Returns an array of [month, year] counting back from the given month, year,
+  # by the given num_prior
+  def self.months_prior(year, month, num_prior)
+    count = num_prior.to_i
+    y = year.to_i
+    m = month.to_i
+    result = []
+    while count > 0
+      result << [m, y]
+      if m == 1
+        y -= 1
+        m = 12
+      else
+        m -= 1
+      end
+      count -= 1
+    end
+    return result
+  end
+
+  # Returns an array of [month, year] counting forward from the given month,
+  # year, by the given num_prior
+  def self.months_ahead(year, month, num_ahead)
+    count = num_ahead.to_i
+    y = year.to_i
+    m = month.to_i
+    result = []
+    while count > 0
+      result << [m, y]
+      if m == 12
+        y += 1
+        m = 1
+      else
+        m += 1
+      end
+      count -= 1
+    end
+    return result
+  end
+
+  def self.natural_year_months(year)
+    result = Array.new
+    for month in 1..12
+      result << [month, year]
+    end
+    result
+  end
+
+  # Returns an array of [year, month] starting from start_date and counting to
+  # end_date
+  def self.months_between(start_date, end_date)
+    if start_date && end_date
+      cur_year = start_date.year
+      cur_month = start_date.month
+      result = [[cur_month, cur_year]]
+      while cur_year < end_date.year || cur_month < end_date.month
+        if cur_month >= 12
+          cur_month = 0
+          cur_year += 1
+        end
+        cur_month += 1
+        result << [cur_month, cur_year]
+      end
+      result
+    else
+      []
+    end
+  end
+
+  # Returns an array of ranges for start_date =>
+  # month_start_date..month_end_date
+  def self.financial_year_month_ranges(starting_year)
+    result = Array.new
+    financial_months(starting_year).each {|m|
+      result << month_range(m[1], m[0])
+    }
+    result
+  end
+
+  #Return the first_day_of_month for each month of the financial year of starting_year
+  def self.financial_year_start_months(starting_year)
+    result = Array.new
+    financial_months(starting_year).each {|m|
+      result << Date.new(m[1],m[0], 01)
+    }
+    result
+  end
+
+  def self.last_day_of_month(year, month)
+    last_date_of_month(year.to_i, month.to_i).day
+  end
+
+  def self.last_date_of_month(year, month)
+    d = Date.new(year.to_i, month.to_i, -1)
+    d
+  end
+
+  # Returns a range from the first day to the last day of the month.
+  def self.month_range(year, month)
+    last_day = last_date_of_month(year, month)
+    Range.new(Date.new(year.to_i, month.to_i, 1), last_day)
+  end
+
+  # Returns a range from the first day to the last day of the previous month
+  def self.previous_month_range(year,month)
+      y = month == 1 ? year - 1 : year
+      m = month == 1 ? 12 : month - 1
+      month_range(y,m)
+  end
+
+  # Returns a range from the first day to the last day of the next month
+  def self.next_month_range(year,month)
+      y = month == 12 ? year + 1 : year
+      m = month == 12 ? 1 : month + 1
+      month_range(y,m)
+  end
+
+  # Returns a hash with :first_day_of_month => (<first day of month>..<end of
+  # month>)
+  def self.month_range_condition(year, month)
+    {:first_day_of_month => month_range(year, month)}
+  end
+
+  # returns an array with a start and end date for the given australian
+  # financial year.
+  def self.financial_year_dates(year)
+    [financial_year_start_date(year), financial_year_end_date(year)]
+  end
+
+  def self.financial_year_range(starting_year)
+    fyr = financial_year_dates(starting_year)
+    Range.new(fyr[0], fyr[1])
+  end
+
+  def self.financial_years_range(starting_year, finishing_year)
+    Range.new(financial_year_start_date(starting_year), financial_year_end_date(finishing_year))
+  end
+
+  def self.financial_year_start_date(year)
+    if year.is_a? Date
+      year = if year.month >= 7
+               year.year
+             else
+               year.year - 1
+             end
+    end
+    Date.new(year.to_i, 7, 1)
+  end
+
+  def self.financial_year_end_date(year)
+    if year.is_a? Date
+      year = if year.month >= 7
+               year.year
+             else
+               year.year - 1
+             end
+    end
+    Date.new(year.to_i + 1, 6, 30)
+  end
+
+  def self.natural_year_dates(year)
+    [Date.new(year.to_i, 1, 1), Date.new(year.to_i, 12, 31)]
+  end
+
+  def self.natural_year_range(year)
+    nyr = natural_year_dates(year)
+    Range.new(nyr[0], nyr[1])
+  end
+
+  def self.year_range(year, financial = true)
+    return Year.financial_year_range(year) if financial
+    Year.natural_year_range(year)
+  end
+
+  def self.year_conditions(year, financial = true)
+    return Year.financial_year_conditions(year) if financial
+    Year.natural_year_conditions(year)
+  end
+
+  def self.natural_year_conditions(year)
+    {:start_date => natural_year_range(year)}
+  end
+
+  def self.financial_year_conditions(starting_year)
+    {:start_date => financial_year_range(starting_year)}
+  end
+
+  def self.useable_natural_years(start_year = START_YEAR)
+    result = Array.new
+    (start_year..DateTime.now.year).each {|y| result << y}
+    result
+  end
+
+  def self.useable_financial_years(start_year = START_YEAR)
+    result = Array.new
+    now = DateTime.now
+    y = now.year.to_i
+    m = now.month.to_i
+    c = y - 1
+    c = y if m >= 7
+    (start_year..c).each {|y| result << [financial_year_label(y), y.to_s]}
+    result
+  end
+
+  def self.financial_year_label(starting_year)
+    next_year = (starting_year.to_i + 1).to_s[-1,1]
+    next_year = (starting_year.to_i + 1).to_s[-2,2] if (starting_year.to_i + 1).to_s[-2,2].to_i > 9
+    "#{starting_year}-#{next_year}"
+  end
+
+  def self.in_financial_year?(date, starting_year)
+    financial_year_range(starting_year).include?(date)
+  end
+
+  def self.financial_year_of(date)
+    year = date.year
+    month = date.month
+    return year - 1 if month < 7
+    year
+  end
+
+  def self.natural_years_range(starting_year, finishing_year)
+    Range.new(Date.new(starting_year, 01, 01), last_date_of_month(finishing_year,12))
+  end
+
+  def self.financial_year_first_label(date)
+    year = date.year
+    if date.month > 6
+      year
+    else
+      year - 1
+    end
+  end
+
+  def self.current_financial_year
+    current_year = Date.today.year
+    month = Date.today.month
+    month >= 7 ? current_year : current_year - 1
+  end
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: activesupport-fiscal_dates
+version: !ruby/object:Gem::Version
+  version: 1.0.3
+platform: ruby
+authors:
+- Kinesis Pty Ltd
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+description: Adds fiscal date support to Date objects
+email:
+- devs@kinesis.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- activesupport-fiscal_dates.gemspec
+- circle.yml
+- lib/active_support/fiscal_dates/date.rb
+- lib/active_support/fiscal_dates/version.rb
+- lib/activesupport-fiscal_dates.rb
+- spec/lib/active_support/fiscal_dates/date_spec.rb
+- spec/spec_helper.rb
+- year.rb
+homepage: https://github.com/kinesisptyltd/activesupport-fiscal_dates
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Adds fiscal date support
+test_files:
+- spec/lib/active_support/fiscal_dates/date_spec.rb
+- spec/spec_helper.rb