datey 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ab3c2439b0aed6242f6fb27a7629c592d426d081
+  data.tar.gz: bd46309c4ad4fa17ef2dd06bf4b84d4a1d67eb02
+SHA512:
+  metadata.gz: 6eb8ef6d1d567d3544b1a311374f3645181733cd6e3d80af84ea0904dc898750ce213e314d0122b245bc80254397745ed8532eff1da03fa61e97f8912ced997f
+  data.tar.gz: 94e6799a6490352c57c836073ea6f1b01b7c7b3a8e431fdfde48e30c0e6bc211fa021e7fc10bd3692351a4b83469b44fd96187514dd0029115a2a20cc6cea1da

data/lib/datey.rb

@@ -0,0 +1,14 @@
+require 'datey/formatter'
+require 'datey/interrogator'
+
+module Datey
+  
+  def self.format(date)
+    Formatter.new(date)
+  end
+  
+  def self.interrogate(date)
+    Interrogator.new(date)
+  end
+  
+end

data/lib/datey/formatter.rb

@@ -0,0 +1,105 @@
+require 'date'
+require 'datey/interrogator'
+
+module Datey
+  class Formatter
+
+    def initialize(time)
+      @time = time
+    end
+    
+    #
+    # Return the date and time
+    #
+    def date_and_time
+      "#{date} at #{time}"
+    end
+    
+    # 
+    # Return the time nicely
+    #
+    def time
+      if @time.is_a?(Time)
+        @time.strftime("%l#{@time.min > 0 ? ":%M" : ''}%P").strip
+      else
+        nil
+      end
+    end
+    
+    #
+    # Return the formatted date (no time)
+    #
+    def date
+      if interrogator.today?
+        "Today"
+      elsif interrogator.yesterday?
+        "Yesterday"
+      elsif interrogator.tomorrow?
+        "Tomorrow"
+      elsif interrogator.last_x_days?(7)
+        "Last #{name_of_day}"
+      elsif interrogator.next_x_days?(6)
+        name_of_day
+      elsif interrogator.next_week?
+        "Next #{name_of_day}"
+      else
+        string = "#{name_of_day} #{day_of_month} #{name_of_month}"
+        string += " #{@time.year}" if include_year_in_dates?
+        string
+      end
+    end
+    
+    #
+    # Return the day of the month ordinalized
+    #
+    def day_of_month
+      ordinal = case @time.day
+      when 1 then "st"
+      when 2 then "nd"
+      when 3 then "rd"
+      else "th"
+      end
+      "#{@time.day}#{ordinal}"
+    end
+    
+    #
+    # Return the name of the day
+    #
+    def name_of_day(style = :full)
+      @time.strftime(style == :full ? "%A" : "%a")
+    end
+    
+    #
+    # Return the name of the month
+    #
+    def name_of_month(style = :full)
+      @time.strftime(style == :full ? "%B" : "%b")
+    end
+    
+    private
+    
+    #
+    # Return an interrogator object for the date we're formatting
+    #
+    def interrogator
+      @interrogator ||= Interrogator.new(@time.to_date)
+    end
+    
+    #
+    # Should years be included in dates?
+    #
+    def include_year_in_dates?
+      if @time.year != Date.today.year
+        # If the year was in the past, always include the year 
+        return true
+      end
+      
+      if @time.year == Date.today.year && @time.month < (Date.today.month - 4)
+        # If the year is this year, include if it happened more than 6 months
+        # ago.
+        return true
+      end
+    end
+    
+  end
+end

data/lib/datey/interrogator.rb

@@ -0,0 +1,91 @@
+require 'date'
+
+module Datey
+  class Interrogator
+
+    def initialize(date)
+      @date = date.to_date
+      @today = Date.today
+    end
+
+    #
+    # Does the time occur today?
+    #
+    def today?
+      @date == @today
+    end
+
+    #
+    # Does the time occur tomorrow?
+    #
+    def tomorrow?
+      @date == (@today + 1)
+    end
+
+    #
+    # Does the time occur yesterday?
+    #
+    def yesterday?
+      @date == (@today - 1)
+    end
+
+    #
+    # Does the date exist in the full week prior to the current week
+    #
+    def last_week?
+      beginning_of_previous_week = beginning_of_current_week - 7
+      @date >= beginning_of_previous_week && @date < beginning_of_previous_week + 7
+    end
+
+    #
+    # Does the date occur in the last X days not including today?
+    #
+    def last_x_days?(days)
+      @date >= (@today - days) && @date < @today
+    end
+    
+    #
+    # Does the date occur in the next X days not including today?
+    #
+    def next_x_days?(days)
+      @date > @today && @date <= (@today + days)
+    end
+
+    #
+    # Does the date existing in this week.
+    #
+    def this_week?
+      @date >= beginning_of_current_week && @date < beginning_of_current_week + 7
+    end
+
+    #
+    # Does the date occur next week? Assuming the next Sunday is the 
+    # start of the next week.
+    #
+    def next_week?
+      beginning_of_next_week = beginning_of_current_week + 7
+      @date >= beginning_of_next_week && @date < beginning_of_next_week + 7
+    end
+
+    #
+    # Is the time in the past
+    #
+    def past?
+      @date < @today
+    end
+    
+    #
+    # Is the time in the future
+    #
+    def future?
+      @date > @today
+    end
+
+    private
+
+    def beginning_of_current_week
+      @beginning_of_current_week ||= @today - @today.wday
+    end
+
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: datey
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Adam Cooke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-16 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby library for formatting & interrogating dates & times
+email:
+- me@adamcooke.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/datey.rb
+- lib/datey/formatter.rb
+- lib/datey/interrogator.rb
+homepage: https://github.com/adamcooke/datey
+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.2.2
+signing_key: 
+specification_version: 4
+summary: A Ruby library for formatting & interrogating dates & times
+test_files: []
+has_rdoc: