time_date_helpers 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store

data/Gemfile

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

data/Rakefile

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

data/lib/time_date_helpers.rb

@@ -0,0 +1,6 @@
+# Provided by bundler to track the version
+require "time_date_helpers/version"
+
+# Our code broken into submodules
+require "time_date_helpers/time_helpers"
+require "time_date_helpers/date_helpers"

data/lib/time_date_helpers/date_helpers.rb

@@ -0,0 +1,37 @@
+module TimeDateHelpers
+  module DateHelpers
+    # convert a date to human format of mm/dd/yyyy
+    def humanize_date(date, opt={})
+      # Set the default options
+      options = {:style => :calendar}
+      # Merge whatever options the user has selected with the defaults
+      options.merge!(opt)
+      # Make sure what is passed is legit
+      return nil if date.nil? 
+      return nil unless date.class == Date || date.class == Time || date.class == DateTime
+      if options[:style] == :calendar
+        date.strftime("%m/%d/%Y")
+      elsif options[:style] == :full
+        date.day < 10 ? date.strftime("%B%e, %Y") : date.strftime("%B %e, %Y")
+      else 
+        nil
+      end
+    end
+
+    # convert a string to a date (using Chronic, of course)
+    def convert_to_date(string)
+      return nil if (string.nil? || string.class != String)
+      tmp = Chronic.parse(string)
+      tmp ? tmp.to_date : nil
+    end
+
+    # convert a string to a datetime (Chronic's default)
+    def convert_to_datetime(string)
+      return nil if (string.nil? || string.class != String)
+      Chronic.parse(string)
+    end
+  end
+end
+
+# Add methods to Object so can be called directly in main
+Object.send :include, TimeDateHelpers::DateHelpers

data/lib/time_date_helpers/time_helpers.rb

@@ -0,0 +1,41 @@
+module TimeDateHelpers
+  module TimeHelpers
+    def round_minutes(time, opt={})
+      # Set the default options
+      options = {:direction => :up, :increment => 15}
+      # Merge whatever options the user has selected with the defaults
+      options.merge!(opt)
+
+      # make sure that increment is a Fixnum between 1 and 59
+      return nil unless options[:increment].class == Fixnum
+      return nil if (options[:increment] > 59 || options[:increment] < 1)
+
+      # Set up some local variables used in calculations
+      new_min, hr_adj = time.min, 0
+      total_segments = (60.0/options[:increment]).ceil # Need to round up
+      closest_segment_down = (new_min/options[:increment])
+      closest_segment_up = (new_min/options[:increment]) + 1
+
+      # Now it is time to actually adjust the minutes (and perhaps hour)
+      if (new_min - options[:increment]*closest_segment_down) == 0
+        new_min  # we are on an increment, so just return the minutes
+      elsif options[:direction] == :up
+        # if rounding up, need to check if up against the end-of-the-hour limit
+        if closest_segment_up == total_segments
+          new_min = 00; hr_adj=1 # near end of hour, so move up to next hour
+        else
+          new_min = options[:increment]*(closest_segment_up)
+        end
+      else
+        # we are rounding down, which is very easy
+        new_min = options[:increment]*(closest_segment_down)
+      end
+
+      # Finally, return the adjusted time
+      Time.new(time.year, time.month, time.day, (time.hour+hr_adj), new_min, 0)
+    end
+  end
+end
+
+# Add to the Object model so can call directly in main
+Object.send :include, TimeDateHelpers::TimeHelpers

data/lib/time_date_helpers/version.rb

@@ -0,0 +1,3 @@
+module TimeDateHelpers
+  VERSION = "0.0.1"
+end

data/time_date_helpers.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "time_date_helpers/version"
+
+Gem::Specification.new do |s|
+  s.name        = "time_date_helpers"
+  s.version     = TimeDateHelpers::VERSION
+  s.authors     = ["Klingon Code Warrior"]
+  s.email       = ["profh@cmu.edu"]
+  s.homepage    = ""
+  s.summary     = %q{A series of helpers to deal with time and date issues in Rails.}
+  s.description = %q{The initial version has only a few date and time helpers and was created primarily for teaching purposes (how to create gems), but does have some value. I will try to get back to this gem and add more methods as time allows.}
+
+  s.rubyforge_project = "time_date_helpers"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "chronic"
+  s.add_runtime_dependency "chronic"
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: time_date_helpers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Klingon Code Warrior
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chronic
+  requirement: &2153346800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2153346800
+- !ruby/object:Gem::Dependency
+  name: chronic
+  requirement: &2153362400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2153362400
+description: The initial version has only a few date and time helpers and was created
+  primarily for teaching purposes (how to create gems), but does have some value.
+  I will try to get back to this gem and add more methods as time allows.
+email:
+- profh@cmu.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Rakefile
+- lib/time_date_helpers.rb
+- lib/time_date_helpers/date_helpers.rb
+- lib/time_date_helpers/time_helpers.rb
+- lib/time_date_helpers/version.rb
+- time_date_helpers.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: time_date_helpers
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A series of helpers to deal with time and date issues in Rails.
+test_files: []
+has_rdoc: