business_time 0.9.3 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5fe356eb4f4e620e3f3db2aa9242df1c63213500
-  data.tar.gz: d1f662a4f576662e3f6d140970d5b2191016fda8
+SHA256:
+  metadata.gz: 3006a4d1708551ad12693457ba051e16b0b8f94439cc8cca54999519d20a5a63
+  data.tar.gz: 785c54ba3652f861532d1963dff4afbcb8194b78ffb7a46de3932778aafb6703
 SHA512:
-  metadata.gz: 86434d31fbf26aa3372510db883266643431a449fa2980cee43e9d34198c140a560d0606d41911aa0a47e030b373eeba0442f38dad07c36a5b5113a811c97213
-  data.tar.gz: 5c1ae7866418a21538030ba2129698eaafb2016b5d715cd2c13e31e1739b8732ff625af6f87e48e98bbe697ea06005d74c35bfab7c8610b306f7ba7c9d0121b5
+  metadata.gz: dac78848ef4878c0891b30f3eb8842578047eb3ae559681e25f7f5dbac885643719fa28ebab37af36daa26d5278cc88f9e40c8919bfbb9b26aa8d38e625c25b2
+  data.tar.gz: 73529a47adeb15c99c0cc06143ee70bb5f2eeb6ee4f0da6c2cff79970082f742aeb412f4e0d201643bb60b9c024dea51c96b0db67ff4220f9a0ca51049264ca8

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2016 bokmann
+Copyright (c) 2009-2022 bokmann
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/business_time/business_days.rb

@@ -5,7 +5,7 @@ module BusinessTime
     include Comparable
     attr_reader :days
 
-    def initialize(days)
+    def initialize(days, options={})
       @days = days
     end
 
@@ -16,15 +16,15 @@ module BusinessTime
       self.days <=> other.days
     end
 
-    def after(time = Time.current)
-      non_negative_days? ? calculate_after(time, @days) : calculate_before(time, -@days)
+    def after(time = Time.current, options={})
+      non_negative_days? ? calculate_after(time, @days, options) : calculate_before(time, -@days, options)
     end
 
     alias_method :from_now, :after
     alias_method :since, :after
 
-    def before(time = Time.current)
-      non_negative_days? ? calculate_before(time, @days) : calculate_after(time, -@days)
+    def before(time = Time.current, options={})
+      non_negative_days? ? calculate_before(time, @days, options) : calculate_after(time, -@days, options)
     end
 
     alias_method :ago, :before
@@ -36,29 +36,35 @@ module BusinessTime
       @days >= 0
     end
 
-    def calculate_after(time, days)
-      while days > 0 || !time.workday?
-        days -= 1 if time.workday?
+    def calculate_after(time, days, options={})
+      if (time.is_a?(Time) || time.is_a?(DateTime)) && !time.workday?(options)
+        time = Time.beginning_of_workday(time)
+      end
+      while days > 0 || !time.workday?(options)
+        days -= 1 if time.workday?(options)
         time += 1.day
       end
       # If we have a Time or DateTime object, we can roll_forward to the
       #   beginning of the next business day
       if time.is_a?(Time) || time.is_a?(DateTime)
-        time = Time.roll_forward(time) unless time.during_business_hours?
+        time = Time.roll_forward(time, options) unless time.during_business_hours?
       end
       time
     end
 
-    def calculate_before(time, days)
-      while days > 0 || !time.workday?
-        days -= 1 if time.workday?
+    def calculate_before(time, days, options={})
+      if (time.is_a?(Time) || time.is_a?(DateTime)) && !time.workday?(options)
+        time = Time.beginning_of_workday(time)
+      end
+      while days > 0 || !time.workday?(options)
+        days -= 1 if time.workday?(options)
         time -= 1.day
       end
       # If we have a Time or DateTime object, we can roll_backward to the
       #   beginning of the previous business day
       if time.is_a?(Time) || time.is_a?(DateTime)
         unless time.during_business_hours?
-          time = Time.beginning_of_workday(Time.roll_backward(time))
+          time = Time.beginning_of_workday(Time.roll_backward(time, options))
         end
       end
       time

data/lib/business_time/business_hours.rb

@@ -3,8 +3,8 @@ module BusinessTime
   class BusinessHours
     include Comparable
     attr_reader :hours
-    
-    def initialize(hours)
+
+    def initialize(hours, options={})
       @hours = hours
     end
 
@@ -15,21 +15,21 @@ module BusinessTime
       self.hours <=> other.hours
     end
     
-    def ago
-      Time.zone ? before(Time.zone.now) : before(Time.now)
+    def ago(options={})
+      Time.zone ? before(Time.zone.now, options) : before(Time.now, options)
     end
 
-    def from_now
-      Time.zone ?  after(Time.zone.now) : after(Time.now)
+    def from_now(options={})
+      Time.zone ?  after(Time.zone.now, options) : after(Time.now, options)
     end
 
-    def after(time)
-      non_negative_hours? ? calculate_after(time, @hours) : calculate_before(time, -@hours)
+    def after(time, options={})
+      non_negative_hours? ? calculate_after(time, @hours, options) : calculate_before(time, -@hours, options)
     end
     alias_method :since, :after
 
-    def before(time)
-      non_negative_hours? ? calculate_before(time, @hours) : calculate_after(time, -@hours)
+    def before(time, options={})
+      non_negative_hours? ? calculate_before(time, @hours, options) : calculate_after(time, -@hours, options)
     end
 
     private
@@ -38,18 +38,18 @@ module BusinessTime
       @hours >= 0
     end
 
-    def calculate_after(time, hours)
-      after_time = Time.roll_forward(time)
+    def calculate_after(time, hours, options={})
+      after_time = Time.roll_forward(time, options)
       # Step through the hours, skipping over non-business hours
       hours.times do
         after_time = after_time + 1.hour
 
         if after_time.hour == 0 && after_time.min == 0 && after_time.sec == 0
-          after_time = Time.roll_forward(after_time)
+          after_time = Time.roll_forward(after_time, options)
         elsif (after_time > Time.end_of_workday(after_time))
           # Ignore hours before opening and after closing
           delta = after_time - Time.end_of_workday(after_time)
-          after_time = Time.roll_forward(after_time) + delta
+          after_time = Time.roll_forward(after_time, options) + delta
         end
 
         # Ignore weekends and holidays
@@ -60,20 +60,20 @@ module BusinessTime
       after_time
     end
 
-    def calculate_before(time, hours)
+    def calculate_before(time, hours, options={})
       before_time = Time.roll_backward(time)
       # Step through the hours, skipping over non-business hours
       hours.times do
         before_time = before_time - 1.hour
 
         if before_time.hour == 0 && before_time.min == 0 && before_time.sec == 0
-          before_time = Time.roll_backward(before_time - 1.second)
+          before_time = Time.roll_backward(before_time - 1.second, options)
         elsif (before_time <= Time.beginning_of_workday(before_time))
           # Ignore hours before opening and after closing
           delta = Time.beginning_of_workday(before_time) - before_time
 
           # Due to the 23:59:59 end-of-workday exception
-          time_roll_backward = Time.roll_backward(before_time)
+          time_roll_backward = Time.roll_backward(before_time, options)
           time_roll_backward += 1.second if time_roll_backward.iso8601 =~ /23:59:59/
 
           before_time = time_roll_backward - delta

data/lib/business_time/config.rb

@@ -7,7 +7,7 @@ module BusinessTime
   # manually, or with a yaml file and the load method.
   class Config
     DEFAULT_CONFIG = {
-      holidays:              SortedSet.new,
+      holidays:              Set.new,
       beginning_of_workday:  ParsedTime.parse('9:00 am'),
       end_of_workday:        ParsedTime.parse('5:00 pm'),
       work_week:             %w(mon tue wed thu fri),
@@ -80,23 +80,7 @@ module BusinessTime
       end
     end
 
-    # You can set this yourself, either by the load method below, or
-    # by saying
-    #   BusinessTime::Config.beginning_of_workday = "8:30 am"
-    # someplace in the initializers of your application.
-    threadsafe_cattr_reader :beginning_of_workday
-
-    # You can set this yourself, either by the load method below, or
-    # by saying
-    #   BusinessTime::Config.end_of_workday = "5:30 pm"
-    # someplace in the initializers of your application.
-    threadsafe_cattr_reader :end_of_workday
-
-    # You can set this yourself, either by the load method below, or
-    # by saying
-    #   BusinessTime::Config.work_week = [:sun, :mon, :tue, :wed, :thu]
-    # someplace in the initializers of your application.
-    threadsafe_cattr_accessor :work_week
+    threadsafe_cattr_reader :work_week
 
     # You can set this yourself, either by the load method below, or
     # by saying
@@ -118,6 +102,10 @@ module BusinessTime
     threadsafe_cattr_accessor :fiscal_month_offset
 
     class << self
+      # You can set this yourself, either by the load method below, or
+      # by saying
+      #   BusinessTime::Config.end_of_workday = "5:30 pm"
+      # someplace in the initializers of your application.
       def end_of_workday(day=nil)
         if day
           wday = work_hours[int_to_wday(day.wday)]
@@ -127,6 +115,10 @@ module BusinessTime
         end
       end
 
+      # You can set this yourself, either by the load method below, or
+      # by saying
+      #   BusinessTime::Config.beginning_of_workday = "8:30 am"
+      # someplace in the initializers of your application.
       def beginning_of_workday(day=nil)
         if day
           wday = work_hours[int_to_wday(day.wday)]
@@ -136,6 +128,10 @@ module BusinessTime
         end
       end
 
+      # You can set this yourself, either by the load method below, or
+      # by saying
+      #   BusinessTime::Config.work_week = [:sun, :mon, :tue, :wed, :thu]
+      # someplace in the initializers of your application.
       def work_week=(days)
         config[:work_week] = days
         self._weekdays = nil
@@ -148,7 +144,7 @@ module BusinessTime
           wday_to_int(day_name)
         end.compact
 
-        self._weekdays = SortedSet.new(days)
+        self._weekdays = days.sort.to_set
       end
 
       # loads the config data from a yaml file written as:
@@ -190,13 +186,18 @@ module BusinessTime
 
       private
 
+      DAY_NAMES = [
+        'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'
+      ]
+      private_constant :DAY_NAMES
+
       def wday_to_int day_name
-        lowercase_day_names = ::Time::RFC2822_DAY_NAME.map(&:downcase)
+        lowercase_day_names = DAY_NAMES.map(&:downcase)
         lowercase_day_names.find_index(day_name.to_s.downcase)
       end
 
       def int_to_wday num
-        ::Time::RFC2822_DAY_NAME.map(&:downcase).map(&:to_sym)[num]
+        DAY_NAMES.map(&:downcase).map(&:to_sym)[num]
       end
 
       def reset

data/lib/business_time/core_ext/date.rb

@@ -2,15 +2,15 @@
 class Date
   include BusinessTime::TimeExtensions
 
-  def business_days_until(to_date, inclusive = false)
-    business_dates_until(to_date, inclusive).size
+  def business_days_until(to_date, inclusive = false, options={})
+    business_dates_until(to_date, inclusive, options).size
   end
 
-  def business_dates_until(to_date, inclusive = false)
+  def business_dates_until(to_date, inclusive = false, options={})
     if inclusive
-      (self..to_date).select(&:workday?)
+      (self..to_date).select{|this_date| this_date.workday?(options)}
     else
-      (self...to_date).select(&:workday?)
+      (self...to_date).select{|this_date| this_date.workday?(options)}
     end
   end
 

data/lib/business_time/core_ext/integer.rb

@@ -4,13 +4,13 @@
 #  3.business_days.after(some_date)
 #  4.business_hours.before(some_date_time)
 class Integer
-  def business_hours
-    BusinessTime::BusinessHours.new(self)
+  def business_hours(options={})
+    BusinessTime::BusinessHours.new(self, options)
   end
   alias_method :business_hour, :business_hours
 
-  def business_days
-    BusinessTime::BusinessDays.new(self)
+  def business_days(options={})
+    BusinessTime::BusinessDays.new(self, options)
   end
   alias_method :business_day, :business_days
 end

data/lib/business_time/time_extensions.rb

@@ -2,8 +2,12 @@ module BusinessTime
   module TimeExtensions
     # True if this time is on a workday (between 00:00:00 and 23:59:59), even if
     # this time falls outside of normal business hours.
-    def workday?
-      weekday? && !BusinessTime::Config.holidays.include?(to_date)
+    # holidays option allows you to pass in a different Array of holiday dates on
+    # each call vs the BusinessTime::Config.holidays which is always static.
+    def workday?(options={})
+      weekday? &&
+        !BusinessTime::Config.holidays.include?(to_date) &&
+        !to_array_of_dates(options[:holidays]).include?(to_date)
     end
 
     # True if this time falls on a weekday.
@@ -32,9 +36,9 @@ module BusinessTime
 
       # True if this time is on a workday (between 00:00:00 and 23:59:59), even if
       # this time falls outside of normal business hours.
-      def workday?(day)
+      def workday?(day, options={})
         ActiveSupport::Deprecation.warn("`Time.workday?(time)` is deprecated. Please use `time.workday?`")
-        day.workday?
+        day.workday?(options)
       end
 
       # True if this time falls on a weekday.
@@ -53,9 +57,8 @@ module BusinessTime
 
       # Rolls forward to the next beginning_of_workday
       # when the time is outside of business hours
-      def roll_forward(time)
-
-        if Time.before_business_hours?(time) || !time.workday?
+      def roll_forward(time, options={})
+        if Time.before_business_hours?(time) || !time.workday?(options)
           next_business_time = Time.beginning_of_workday(time)
         elsif Time.after_business_hours?(time) || Time.end_of_workday(time) == time
           next_business_time = Time.beginning_of_workday(time + 1.day)
@@ -63,7 +66,7 @@ module BusinessTime
           next_business_time = time.clone
         end
 
-        while !next_business_time.workday?
+        while !next_business_time.workday?(options)
           next_business_time = Time.beginning_of_workday(next_business_time + 1.day)
         end
 
@@ -72,8 +75,8 @@ module BusinessTime
 
       # Returns the time parameter itself if it is a business day
       # or else returns the next business day
-      def first_business_day(time)
-        while !time.workday?
+      def first_business_day(time, options={})
+        while !time.workday?(options)
           time = time + 1.day
         end
 
@@ -82,8 +85,8 @@ module BusinessTime
 
       # Rolls backwards to the previous end_of_workday when the time is outside
       # of business hours
-      def roll_backward(time)
-        prev_business_time = if (Time.before_business_hours?(time) || !time.workday?)
+      def roll_backward(time, options={})
+        prev_business_time = if (Time.before_business_hours?(time) || !time.workday?(options))
                                Time.end_of_workday(time - 1.day)
                              elsif Time.after_business_hours?(time)
                                Time.end_of_workday(time)
@@ -91,7 +94,7 @@ module BusinessTime
                                time.clone
                              end
 
-        while !prev_business_time.workday?
+        while !prev_business_time.workday?(options)
           prev_business_time = Time.end_of_workday(prev_business_time - 1.day)
         end
 
@@ -100,16 +103,16 @@ module BusinessTime
 
       # Returns the time parameter itself if it is a business day
       # or else returns the previous business day
-      def previous_business_day(time)
-        while !time.workday?
+      def previous_business_day(time, options={})
+        while !time.workday?(options)
           time = time - 1.day
         end
 
         time
       end
 
-      def work_hours_total(day)
-        return 0 unless day.workday?
+      def work_hours_total(day, options={})
+        return 0 unless day.workday?(options)
 
         day = day.strftime('%a').downcase.to_sym
 
@@ -136,7 +139,7 @@ module BusinessTime
       end
     end
 
-    def business_time_until(to_time)
+    def business_time_until(to_time, options={})
       # Make sure that we will calculate time from A to B "clockwise"
       if self < to_time
         time_a = self
@@ -149,8 +152,8 @@ module BusinessTime
       end
 
       # Align both times to the closest business hours
-      time_a = Time::roll_forward(time_a)
-      time_b = Time::roll_forward(time_b)
+      time_a = Time::roll_forward(time_a, options)
+      time_b = Time::roll_forward(time_b, options)
 
       if time_a.to_date == time_b.to_date
         time_b - time_a
@@ -166,16 +169,16 @@ module BusinessTime
       end * direction
     end
 
-    def during_business_hours?
-      self.workday? && self.to_i.between?(Time.beginning_of_workday(self).to_i, Time.end_of_workday(self).to_i)
+    def during_business_hours?(options={})
+      self.workday?(options) && self.to_i.between?(Time.beginning_of_workday(self).to_i, Time.end_of_workday(self).to_i)
     end
 
-    def consecutive_workdays
-      workday? ? consecutive_days { |date| date.workday? } : []
+    def consecutive_workdays(options={})
+      workday?(options) ? consecutive_days { |date| date.workday?(options) } : []
     end
 
-    def consecutive_non_working_days
-      !workday? ? consecutive_days { |date| !date.workday? } : []
+    def consecutive_non_working_days(options={})
+      !workday?(options) ? consecutive_days { |date| !date.workday?(options) } : []
     end
 
     private
@@ -194,5 +197,9 @@ module BusinessTime
       end
       (days << self).sort
     end
+
+    def to_array_of_dates(values)
+      Array.wrap(values).map(&:to_date)
+    end
   end
 end

data/lib/business_time/version.rb

@@ -1,3 +1,3 @@
 module BusinessTime
-  VERSION = "0.9.3"
+  VERSION = "0.13.0"
 end

data/lib/business_time.rb

@@ -1,9 +1,10 @@
-require 'thread'
-require 'active_support'
-require 'active_support/time'
+require 'set'
 require 'time'
 require 'yaml'
 
+require 'active_support'
+require 'active_support/time'
+
 require 'business_time/parsed_time'
 require 'business_time/version'
 require 'business_time/config'

data/lib/generators/business_time/config_generator.rb

@@ -1,21 +1,21 @@
 module BusinessTime
   module Generators
     class ConfigGenerator < Rails::Generators::Base # :nodoc:
-      
+
       def self.gem_root
-        File.expand_path("../../../..", __FILE__)
+        File.expand_path("../../..", __dir__)
       end
 
       def self.source_root
         # Use the templates from the 2.3.x generator
         File.join(gem_root, 'rails_generators', 'business_time_config', 'templates')
       end
-      
+
       def generate
         template 'business_time.rb', File.join('config', 'initializers', 'business_time.rb')
         template 'business_time.yml', File.join('config', 'business_time.yml')
       end
-      
+
     end
   end
-end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: business_time
 version: !ruby/object:Gem::Version
-  version: 0.9.3
+  version: 0.13.0
 platform: ruby
 authors:
 - bokmann
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-11-04 00:00:00.000000000 Z
+date: 2022-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -102,7 +102,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
-- README.rdoc
 - lib/business_time.rb
 - lib/business_time/business_days.rb
 - lib/business_time/business_hours.rb
@@ -122,7 +121,7 @@ homepage: https://github.com/bokmann/business_time
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -137,9 +136,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
-signing_key: 
+rubygems_version: 3.3.12
+signing_key:
 specification_version: 4
 summary: Support for doing time math in business hours and days
 test_files: []

data/README.rdoc

@@ -1,223 +0,0 @@
-= business_time
-
-{<img src="https://secure.travis-ci.org/bokmann/business_time.png" />}[http://travis-ci.org/bokmann/business_time]
-
-ActiveSupport gives us some great helpers so we can do things like:
-
-  5.days.ago
-
-and
-
-  8.hours.from_now
-
-as well as helpers to do that from any provided date or time.
-
-I needed this, but taking into account business hours/days and holidays.
-
-== Usage
-=== install the gem
-
-    gem install business_time
-
-=== open up your console
-
-    # if in irb, add these lines:
-
-    require 'business_time'
-
-    # try these examples, using the current time:
-
-    1.business_hour.from_now
-    4.business_hours.from_now
-    8.business_hours.from_now
-
-    1.business_hour.ago
-    4.business_hours.ago
-    8.business_hours.ago
-
-    1.business_day.from_now
-    4.business_days.from_now
-    8.business_days.from_now
-
-    1.business_day.ago
-    4.business_days.ago
-    8.business_days.ago
-
-    Date.today.workday?
-    Date.parse("2015-12-09").workday?
-    Date.parse("2015-12-12").workday?
-
-And we can do it from any Date or Time object.
-    my_birthday = Date.parse("August 4th, 1969")
-    8.business_days.after(my_birthday)
-    8.business_days.before(my_birthday)
-
-    my_birthday = Time.parse("August 4th, 1969, 8:32 am")
-    8.business_days.after(my_birthday)
-    8.business_days.before(my_birthday)
-
-
-We can adjust the start and end time of our business hours
-    BusinessTime::Config.beginning_of_workday = "8:30 am"
-    BusinessTime::Config.end_of_workday = "5:30 pm"
-
-and we can add holidays that don't count as business days
-July 5 in 2010 is a monday that the U.S. takes off because our independence day falls on that Sunday.
-    three_day_weekend = Date.parse("July 5th, 2010")
-    BusinessTime::Config.holidays << three_day_weekend
-    friday_afternoon = Time.parse("July 2nd, 2010, 4:50 pm")
-    tuesday_morning = 1.business_hour.after(friday_afternoon)
-
-plus, we can change the work week:
-    # July 9th in 2010 is a Friday.
-    BusinessTime::Config.work_week = [:sun, :mon, :tue, :wed, :thu]
-    thursday_afternoon = Time.parse("July 8th, 2010, 4:50 pm")
-    sunday_morning = 1.business_hour.after(thursday_afternoon)
-
-As alternative we also can change the business hours for each work day:
-    BusinessTime::Config.work_hours = {
-      :mon=>["9:00","17:00"],
-      :fri=>["9:00","17:00"],
-      :sat=>["10:00","15:00"]
-    }
-    friday = Time.parse("December 24, 2010 15:00")
-    monday = Time.parse("December 27, 2010 11:00")
-    working_hours = friday.business_time_until(monday) # 9.hours
-
-You can also calculate business duration between two dates
-    friday = Date.parse("December 24, 2010")
-    monday = Date.parse("December 27, 2010")
-    friday.business_days_until(monday) #=> 1
-
-Or you can calculate business duration between two Time objects
-    ticket_reported = Time.parse("February 3, 2012, 10:40 am")
-    ticket_resolved = Time.parse("February 4, 2012, 10:50 am")
-    ticket_reported.business_time_until(ticket_resolved) #=> 8.hours + 10.minutes
-
-You can also determine if a given time is within business hours
-    Time.parse("February 3, 2012, 10:00 am").during_business_hours?
-
-Note that counterintuitively, durations might not be quite what you expect when involving weekends.
-Consider the following example:
-    ticket_reported = Time.parse("February 3, 2012, 10:40 am")
-    ticket_resolved = Time.parse("February 4, 2012, 10:40 am")
-    ticket_reported.business_time_until(ticket_resolved) # will equal 6 hours and 20 minutes!
-
-Why does this happen?  Feb 4 2012 is a Saturday.  That time will roll over to
-Monday, Feb 6th 2012, 9:00am.  The business time between 10:40am friday and 9am monday is
-6 hours and 20 minutes. From a quick inspection of the code, it looks like it should be 8 hours.
-
-Or you can calculate business dates between two dates
-    monday = Date.parse("December 20, 2010")
-    wednesday = Date.parse("December 22, 2010")
-    monday.business_dates_until(wednesday) #=> [Mon, 20 Dec 2010, Tue, 21 Dec 2010]
-
-You can get the first workday after a time or return itself if it is a workday
-    saturday = Time.parse("Sat Aug 9, 18:00:00, 2014")
-    monday = Time.parse("Mon Aug 11, 18:00:00, 2014")
-    Time.first_business_day(saturday) #=> "Mon Aug 11, 18:00:00, 2014"
-    Time.first_business_day(monday) #=> "Mon Aug 11, 18:00:00, 2014"
-
-    # similar to Time#first_business_day Time#previous_business_day only cares about
-    # workdays:
-    saturday = Time.parse("Sat Aug 9, 18:00:00, 2014")
-    monday = Time.parse("Mon Aug 11, 18:00:00, 2014")
-    Time.previous_business_day(saturday) #=> "Fri Aug 8, 18:00:00, 2014"
-    Time.previous_business_day(monday) #=> "Mon Aug 11, 18:00:00, 2014"
-== Rails generator
-
-    rails generate business_time:config
-
-The generator will add a ./config/business_time.yml and a ./config/initializers/business_time.rb
-file that will cause the start of business day, the end of business day, and your holidays to be loaded from the yaml file.
-
-You might want to programatically load your holidays from a database table,
-but you will want to pay attention to how the initializer works -
-you will want to make sure that the initializer sets stuff up appropriately so
-rails instances on mongrels or passenger will have the appropriate data as they come up and down.
-
-== Timezone support
-This gem strives to be timezone-agnostic.
-Due to some complications in the handling of timezones in the built in Time class,
-and some complexities (bugs?) in the timeWithZone class, this was harder than expected... but here's the idea:
-
-* When you configure the gem with something like 9:00am as the start time,
-  this is agnostic of time zone.
-* When you are dealing with a Time or TimeWithZone class, the timezone is
-  preserved and the beginning and end of times for the business day are
-  referenced in that time zone.
-
-This can lead to some weird looking effects if, say, you are in the Eastern time zone but doing everything in UTC times...
-Your business day will appear to start and end at 9:00 and 5:00 UTC.
-If this seems perplexing to you, I can almost guarantee you are in over your head with timezones in other ways too,
-this is just the first place you encountered it.
-Timezone relative date handling gets more and more complicated every time you look at it and takes a long time before it starts to seem simple again.
-
-== Integration with the Holidays gem
-
-	Chris Wise wrote up a great article[http://murmurinfo.wordpress.com/2012/01/11/handling-holidays-and-business-hours/]
-	on using the business_time gem with the holidays[https://github.com/alexdunae/holidays] gem. It boils down to this:
-
-  Holidays.between(Date.civil(2013, 1, 1), 2.years.from_now, :ca_on, :observed).map do |holiday|
-    BusinessTime::Config.holidays << holiday[:date]
-    # Implement long weekends if they apply to the region, eg:
-    # BusinessTime::Config.holidays << holiday[:date].next_week if !holiday[:date].weekday?
-  end
-
-== Contributors
- * David Bock  http://github.com/bokmann
- * Enrico Bianco  http://github.com/enricob
- * Arild Shirazi  http://github.com/ashirazi
- * Piotr Jakubowski http://github.com/piotrj
- * Glenn Vanderburg http://github.com/glv
- * Michael Grosser http://github.com/grosser
- * Michael Curtis http://github.com/mcurtis
- * Brian Ewins http://github.com/bazzargh
-
- (Special thanks for Arild on the complexities of dealing with TimeWithZone)
-
-== Note on Patches/Pull Requests
-
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
-
-== TODO
-
-* Arild has pointed out that there may be some logical inconsistencies
-  regarding the beginning_of_workday and end_of workday times not actually
-  being considered inside of the workday.  I'd like to make sure that they
-  work as if the beginning_of_workday is included and the end_of_workday is
-  not included, just like the '...' range operator in Ruby.
-
-== NOT TODO
-
-* I spent way too much time in my previous java-programmer life building frameworks that worshipped complexity,
-  always trying to give the developer-user ultimate flexibility at the expense of the 'surface area' of the api.
-  Never again - I will sooner limit functionality to 80% so that something stays usable and let people fork.
-* While there have been requests to add 'business minutes' and even 'business seconds' to this gem, I won't
-  entertain a pull request with such things.  If you find it useful, great.  Most users won't, and they don't
-  need the baggage.
-
-
-== A note on stability and change
-
-Sometimes people ask me why this gem doesn't release more often.  My opinions on that are best discussed in person in a friendly discussion, but I'll attempt some of that here.
-
-First, a big part of the reason is that the projects I do use this gem on are happy with it's current functionality.  It is 'suitable for the purpose' for which I released it, and as such, maintenance I do on this gem is a gift to the community.
-
-Second, out of the ~1.3 million downloads (according to rubygems.org), the number of real 'issues' with this gem have been minimal.  Most of the issues that are opened are really people with slightly different requirements than I have regarding whether 'off hours' work counts as the previous or the next business day, a disagreement on the semantics of days vs. hours, etc.  I take care to try to explain these choices in the open issues, but to my mind, they aren't true issues if it's just a difference of opinion.  Even so, I'll gladly accept pull requests that resolve this difference of opinion as a configuration option... just don't expect me to do your job for you.  I've already given you 90% of what you need.
-
-Third, a business time gem is, well, relevant to businesses.  Many businesses don't move quickly.  My government clients move even more slowly.  Stability is favored in these environments.
-
-Fourth, new features can wait.  To the person that adds them they can be mission critical, but with modern packaging processes, they can use their version without waiting for their changes to be included in the upstream version.  Their changes don't break your code.
-
-I'm proud of the work in this gem; the stability is a big part of that.  This gem has lived longer than many others that have attempted to do the same thing.  I expect it to be here chugging away when Ruby has become the next COBOL.
-
-== Copyright
-
-Copyright (c) 2010-2017 bokmann. See LICENSE for details.