asanghi-fiscali 1.1.4 → 1.1.5

data/README.markdown

@@ -26,16 +26,147 @@ Next step is to provide your Date/Time class your start zone. Stick this in an i
 
     Date.fiscal_zone = :india
     Time.fiscal_zone = :india
-    or
+or
     Date.start_month = 4
     
 
 ### Default options
 
-    By default, the financial year start in January. (Correct me but thats not a common start of financial year!)
-    Known Zones are  -
+By default, the financial year start in January. (Correct me but thats not a common start of financial year!)
+Known Zones are  -
     	{:india => 4, :uk => 4, :us => 10, :pakistan => 7,
          :australia => 7, :ireland => 1, :nz => 7, :japan => 4}
 
-## APIs
+## Date or Time Class Methods
+    
+    Date.fy_start_month
+    => 1
+    Date.fiscal_zone = :india
+    => :india
+    Date.fy_start_month
+    => 4
+    Date.fiscal_zone
+    => :india
+    Date.fy_start_month = 7
+    => 7
+    Date.fy_start_month
+    => 7
+    Date.fiscal_zone
+    => nil
+
+If you want to add your own fiscal zone
+
+    RisingSun::Fiscali::FISCAL_ZONE.merge!(:my_own_zone => 2)
+
+should do the trick.
+
+## Date or Time Instance Methods
+
+    Date.fiscal_zone = :india
+    => :india
+    Date.fy_start_month
+    => 4
+    
+Indian Fiscal Year starts from 1st of April
+Assume Date.today is 1st May 2009
+
+ 
+* financial_year
+  Returns the financial year of the date/time
+    Date.today.financial_year
+    => 2009
+    Date.today.beginning_of_year.financial_year
+    => 2008
+ Since 1st Jan 2009 in India falls in the 2008-09 financial year
+
+* beginning_of_financial_year
+  Returns the beginning of financial year
+    Date.today.beginning_of_financial_year
+    => 1st April 2009
+    Date.today.beginning_of_year.beginning_of_financial_year
+    => 1st April 2008
+
+* end_of_financial_year
+
+* beginning_of_financial_q1
+* end_of_financial_q1
+
+* beginning_of_financial_q2
+* end_of_financial_q2
+
+* beginning_of_financial_q3
+* end_of_financial_q3
+
+* beginning_of_financial_q4
+* end_of_financial_q4
+
+* beginning_of_financial_h1
+* end_of_financial_h1
+
+* beginning_of_financial_h2
+* end_of_financial_h2
+
+* financial_quarter
+  Returns Q1, Q2, Q3, Q4 depending on where the date falls
+    Date.today.financial_quarter
+    => Q1
+    Date.today.beginning_of_year.financial_quarter
+    => Q4
+  
+* financial_half
+  Returns H1, H2 depending on where the date falls
+    Date.today.financial_half
+    => H1
+    Date.today.beginning_of_year.financial_half
+    => H2
+  
+* next_financial_quarter
+  Takes you to the beginning of the next financial quarter
+    Date.today.next_financial_quarter
+    => 1st July 2009
+    
+* next_financial_half
+  Takes you to the beginning of the next financial half
+    Date.today.next_financial_half
+    => 1st October 2009
+
+* beginning_of_financial_quarter
+  Take you to the beginning of the current financial quarter
+    Date.today.beginning_of_financial_quarter
+    => 1st April 2009
+    Date.today.beginning_of_year.beginning_of_financial_quarter
+    => 1st Jan 2009
+
+* beginning_of_financial_half
+  Take you to the beginning of the current financial half
+    Date.today.beginning_of_financial_half
+    => 1st April 2009
+    Date.today.beginning_of_year.beginning_of_financial_quarter
+    => 1st Oct 2008
+
+* previous_financial_quarter
+  Take you to the beginning of the previous financial quarter
+    Date.today.previous_financial_quarter
+    => 1st Jan 2009
+    Date.today.beginning_of_year.previous_financial_quarter
+    => 1st Oct 2008
+
+* previous_financial_half
+  Take you to the beginning of the previous financial half
+    Date.today.previous_financial_half
+    => 1st Oct 2008
+    Date.today.beginning_of_year.previous_financial_quarter
+    => 1st Apr 2008
+    
+
+    
+
+
+
+  
+  
+
 
+  
+ 
+ 

data/VERSION

@@ -1 +1 @@
-1.1.4
+1.1.5

data/fiscali.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{fiscali}
-  s.version = "1.1.4"
+  s.version = "1.1.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Aditya Sanghi"]

data/lib/rising_sun/fiscali.rb

@@ -26,6 +26,7 @@ module RisingSun
       end
 
       def fy_start_month=(month)
+      	write_inheritable_attribute(:zone, nil)
         write_inheritable_attribute(:start_month,month)
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: asanghi-fiscali
 version: !ruby/object:Gem::Version 
-  version: 1.1.4
+  version: 1.1.5
 platform: ruby
 authors: 
 - Aditya Sanghi