
Security News
pnpm 10.12 Introduces Global Virtual Store and Expanded Version Catalogs
pnpm 10.12.1 introduces a global virtual store for faster installs and new options for managing dependencies with version catalogs.
alphasights-business_time
Advanced tools
= 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
or
sudo gem install business_time
if you require sudo to install gems
open up your console
require 'rubygems' require 'active_support' require 'business_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
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)
BusinessTime::Config.beginning_of_workday = "8:30 am" BusinessTime::Config.end_of_workday = "5:30 pm"
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)
== Usage in Rails The code above should work on a rails console without any issue. You will want to add a line something like:
config.gem "business_time"
to your environment.rb file. Or if you're using bundler, add this line to your Gemfile:
gem "business_time"
This gem also includes a generator so you can bootstrap some stuff in your environment:
./script/generate business_time_config
Or in Rails 3:
script/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.
== Outside of Rails This code does depend on ActiveSupport, but nothing else within rails. Even then, it would be pretty easy to break that dependency as well (but would add some code bloat and remove some clarity). Feel free to use it on any ruby project you'd like!
== 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:
This can lead to some wierd 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. I'm hoping Arild and I write some good blog entries on the subject at http://blog.codesherpas.com.
== Contributors
(Special thanks for Arild on the complexities of dealing with TimeWithZone)
== Note on Patches/Pull Requests
== TODO
if it doesn't pollute the logic too much, I'd like to vary the days counted as 'business days'. Bakers often don't work on Mondays, for instance. I'd do it in something like this:
BusinessTime::Config.work_week = [:tue, :wed, :thur, :fri, :sat]
Arild has pointed out that there may be some logical inconsistencies regaring 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
== Copyright
Copyright (c) 2010 bokmann. See LICENSE for details.
FAQs
Unknown package
We found that alphasights-business_time demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 10.12.1 introduces a global virtual store for faster installs and new options for managing dependencies with version catalogs.
Security News
Amaro 1.0 lays the groundwork for stable TypeScript support in Node.js, bringing official .ts loading closer to reality.
Research
A deceptive PyPI package posing as an Instagram growth tool collects user credentials and sends them to third-party bot services.