mack-facets 0.8.1 → 0.8.2

data/lib/gems/facets-2.4.5/lib/core/facets/time/round.rb

@@ -0,0 +1,17 @@
+require 'facets/time/trunc'
+
+class Time
+
+  # Round time at the nearest range (in seconds).
+  #
+  #   t = Time.now
+  #   =>
+  #   t.round(60*60) # 1 hour
+  #   =>
+  #  
+  def round(amount)
+    (self+amount/2.0).trunc(amount)
+  end
+
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/time/set.rb

@@ -0,0 +1,21 @@
+class Time
+
+  # Like change but does not reset earlier times.
+  #
+  # NOTE: It would be better, probably if this were called "change".
+  #       and that #change were called "reset".
+  #
+  def set(options)
+    opts={}; options.each_pair{ |k,v| opts[k] = v.to_i }
+    self.class.send( self.utc? ? :utc : :local,
+      opts[:year]  || self.year,
+      opts[:month] || self.month,
+      opts[:day]   || self.day,
+      opts[:hour]  || self.hour,
+      opts[:min]   || self.min,
+      opts[:sec]   || self.sec,
+      opts[:usec]  || self.usec
+    )
+  end
+
+end

data/lib/gems/facets-2.4.5/lib/core/facets/time/stamp.rb

@@ -0,0 +1,44 @@
+class Time
+
+  unless const_defined?('FORMAT')
+    FORMAT = {
+      :db      => "%Y-%m-%d %H:%M:%S",
+      :dbase   => "%Y-%m-%d %H:%M:%S",
+      :datbase => "%Y-%m-%d %H:%M:%S",
+      :utc     => "%Y-%m-%d %H:%M:%S",
+      :number  => "%Y%m%d%H%M%S",
+      :short   => "%d %b %H:%M",
+      :time    => "%H:%M",
+      :long    => "%B %d, %Y %H:%M",
+      :day1st  => "%d-%m-%Y %H:%M",
+      :dmYHM   => "%d-%m-%Y %H:%M",
+      :rfc822  => "%a, %d %b %Y %H:%M:%S %z",
+      nil      => "%a %b %d %H:%M:%S %Z %Y"
+    }
+  end
+
+  # Produce time stamp for Time.now. See #stamp.
+  #
+  #   CREDIT: Trans
+
+  def self.stamp(*args)
+    now.stamp(*args)
+  end
+
+  # Create a time stamp.
+  #
+  #   Time.now.stamp(:short)    #=> "01 Dec 15:15"
+  #
+  # Supported formats come from the Time::FORMAT constant.
+  #
+  #   CREDIT: Trans
+
+  def stamp(fmt = nil)
+    unless String === fmt
+      fmt = FORMAT[fmt]
+    end
+    strftime(fmt).strip
+  end
+
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/time/to_time.rb

@@ -0,0 +1,21 @@
+class Time
+
+  unless defined? to_time #1.9
+
+    # To be able to keep Dates and Times interchangeable
+    # on conversions.
+
+    def to_time
+      getlocal 
+    end
+
+    # A method to keep Time, Date and DateTime instances interchangeable on conversions.
+    # In this case, it simply returns +self+.
+    #def to_time
+    #  self
+    #end
+
+  end
+
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/time/trunc.rb

@@ -0,0 +1,15 @@
+class Time
+
+  # Truncate time at give range (in seconds).
+  #
+  #   t = Time.now
+  #   =>
+  #   t.trunc(60*60) # 1 hour
+  #   =>
+  #
+  def trunc(amount)
+    self - (self.to_i % amount)
+  end
+
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/to_hash.rb

@@ -0,0 +1,87 @@
+class Array
+
+  # Converts a two-element associative array into a hash.
+  #
+  #   a = [ [:a,1], [:b,2] ]
+  #   a.to_h  #=> { :a=>1, :b=>2 }
+  #
+  # If +arrayed+ is set it will maintain trailing arrays.
+  #
+  #   a = [ [:a,1,2], [:b,3] ]
+  #   a.to_h(true)  #=> { :a=>[1,2], :b=>[3] }
+  #
+  # Note that the use of a values parameter has been deprecated
+  # because that functionality is as simple as:
+  #
+  #   array1.zip(array2).to_h
+  #
+  #  CREDIT: Trans
+
+  def to_h(arrayed=nil)
+    h = {}
+    if arrayed #or (flatten.size % 2 == 1)
+      #each{ |e| h[e.first] = e.slice(1..-1) }
+      each{ |k,*v| h[k] = v }
+    else
+      #h = Hash[*flatten(1)] # TODO Use in 1.9 instead.
+      ary = []
+      each do |a|
+        Array===a ? ary.concat(a) : ary << a
+      end
+      h = Hash[*ary]
+    end
+    h
+  end
+
+  #def to_hash
+  #  h = {}
+  #  each_with_index do |v, i|
+  #    h[i] = v
+  #  end
+  #  h
+  #end
+
+end
+
+class Hash
+
+  # Return a rehashing of _self_.
+  #
+  #   {"a"=>1,"b"=>2}.to_h  #=> {"b"=>2,"a"=>1}
+  #
+  # CREDIT: Forian Gross
+
+  def to_h; rehash; end
+
+end
+
+module Enumerable
+
+  # Convert an Enumerable object into a hash by first
+  # turning it into an array.
+  #
+  # CREDIT: Trans
+
+  def to_h(arrayed=nil)
+    to_a.to_h(arrayed)
+  end
+
+  #def to_hash
+  #  to_a.to_hash
+  #end
+
+end
+
+class NilClass
+
+  # Allows <tt>nil</tt> to create an empty hash,
+  # similar to #to_a and #to_s.
+  #
+  #   nil.to_h    #=> {}
+  #
+  # CREDIT: Trans
+
+  def to_h; {}; end
+
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/unboundmethod.rb

@@ -0,0 +1,6 @@
+dir, base = *File.split(__FILE__)
+base = base.chomp('.rb')
+Dir[File.join(dir, base, '*')].each do |lib|
+  require "facets/#{base}/#{File.basename(lib)}"
+end
+

data/lib/gems/facets-2.4.5/lib/core/facets/unboundmethod/arguments.rb

@@ -0,0 +1,44 @@
+class UnboundMethod
+
+  # Resolves the arguments of the method to have an
+  # identical signiture --useful for preserving arity.
+  #
+  #   class X
+  #     def foo(a, b); end
+  #     def bar(a, b=1); end
+  #   end
+  #
+  #   foo_method = X.instance_method(:foo)
+  #   foo_method.arguments   #=> "a0, a1"
+  #
+  #   bar_method = X.instance_method(:bar)
+  #   bar_method.arguments   #=> "a0, *args"
+  #
+  # When defaults are used the arguments must end in "*args".
+  #
+  #   CREDIT: Trans
+
+  def arguments
+    ar = arity
+    case ar <=> 0
+    when 1
+      args = []
+      ar.times do |i|
+        args << "a#{i}"
+      end
+      args = args.join(", ")
+    when 0
+      args = ""
+    else
+      ar = -ar - 1
+      args = []
+      ar.times do |i|
+        args << "a#{i}"
+      end
+      args << "*args"
+      args = args.join(", ")
+    end
+    return args
+  end
+
+end

data/lib/gems/facets-2.4.5/lib/core/facets/unboundmethod/name.rb

@@ -0,0 +1,25 @@
+unless (RUBY_VERSION[0,3] == '1.9')
+
+  class UnboundMethod
+
+    # Return the name of the method.
+    # Is this already in 1.9+ ?
+    #
+    #   class X
+    #     def foo; end
+    #   end
+    #
+    #   meth = X.instance_method(:foo)
+    #
+    #   meth.name  #=> "foo"
+    #
+    #   CREDIT: Trans
+
+    def name
+      i = to_s.rindex('#')
+      to_s.slice(i+1...-1)
+    end
+
+  end
+
+end

data/lib/gems/facets-2.4.5/lib/lore/facets/basicobject.rb

@@ -0,0 +1,14 @@
+# Facets' old BasicObject has been replaced totally replaced by 
+# Jim Weirich's BlankSlate. Since Ruby 1.9 has a BasicObject class
+# this  will of course be deprecated when 1.9 goes mainstream.
+
+unless defined? ::BasicObject  # just in case it already exists!
+
+  require 'facets/blankslate'
+
+  # ActiveSupport compatiable version of BasicObject
+  # if not Ruby 1.9+ uses Jim Weirich's BlankSlate.
+  BasicObject = BlankSlate
+
+end
+

data/lib/gems/facets-2.4.5/lib/lore/facets/cgi.rb

@@ -0,0 +1,50 @@
+# Title:: CGI Extensions
+# Authors:: Trans
+# Copying:: (c)2005 Trans
+# License:: Ruby Licens
+
+require 'cgi'
+
+# = CGI Extensions
+
+class CGI
+
+  # Create an hidden input field through which an object can can be marshalled.
+  # This makes it very easy to pass from data betwenn requests.
+  def marshal_to_cgi(name, iobj)
+    data = CGI.escape(Marshal.dump(iobj))
+    return %Q{<input type="hidden" name="__#{name}__" value="#{data}"/>\n}
+  end
+
+  # Create an hidden input field through which an object can can be marshalled.
+  # This makes it very easy to pass from data between requests.
+  def marshal_from_cgi(name)
+    if self.params.has_key?("__#{name}__")
+      return Marshal.load(CGI.unescape(self["__#{name}__"][0]))
+    end
+  end
+
+  # RENAME!!!!
+
+  # Are these two good enough to replace CGI.escape?
+
+  # Return an html "safe" version of the string,
+  # where every &, < and > are replaced with appropriate entities.
+  def esc(str)
+    str.gsub(/&/,'&amp;').gsub(/</,'&lt;').gsub(/>/,'&gt;')
+  end
+
+  # Calls #esc, and then further replaces carriage returns and quote characters with entities.
+  def escformat(str)
+    esc(str).gsub(/[\r\n]+/,'&#13;&#10;').gsub(%r|"|,'&quot;').gsub(%r|'|,'&#39;')
+  end
+
+  class << self
+    alias :escape_html :escapeHTML
+    alias :unescape_html :unescapeHTML
+    alias :escape_element :escapeElement
+    alias :unescape_element :unescapeElement
+  end
+
+end
+

data/lib/gems/facets-2.4.5/lib/lore/facets/continuation.rb

@@ -0,0 +1,57 @@
+# = Continuation Extension
+#
+# Creates a continuation in a way that is easier to use than callcc.
+# On the initial call this will return the created Continuation and
+# the arguments you gave to Continuation.create in an Array. If you
+# then issue .call() on the Continuation execution will jump back to
+# the point of time where you initially invoked Continuation.create,
+# but this time it will return the Continuation and the arguments
+# you supplied in an Array.
+#
+# You can supply a block instead of default arguments which will
+# cause that block to be executed once and its result to be returned
+# along side the created Continuation, but this form is confusing
+# and does only rarely make sense.
+#
+#   # Count from 0 to 10
+#   cc, counter = Continuation.create(0)
+#   puts counter
+#   cc.call(counter + 1) if counter < 10
+#
+#   # Implement something similar to Array#inject using Continuations.
+#   # For simplicity's sake, this is not fully compatible with the real
+#   # inject. Make sure that you understand Array#inject before you try
+#   # to understand this.
+#   class Array
+#     def cc_inject(value = nil)
+#       copy = self.clone
+#       cc, result, item = Continuation.create(value, nil)
+#       next_item = copy.shift
+#       if result and item
+#         # Aggregate the result using the block.
+#         cc.call(yield(result, item), next_item)
+#       elsif next_item
+#         # item not yet set and Array is not empty:
+#         # This means we did not get a value and thus need to use the
+#         # first item from the Array before we can start using the
+#         # block to aggregate the result.
+#         cc.call(next_item, result)
+#       end
+#
+#       return result
+#    end
+#  end
+#  [1,2,3,4,5].cc_inject { |acc, n| acc + n } # => 15
+#
+
+
+# There is no continuation in Ruby 1.9.
+
+raise "Ruby 1.9+ does not support continuations." unless Continuation
+
+def Continuation.create(*args, &block)
+  args = [args] if not args.nil? and not args.is_a? Array # 1.6.8 compatibility
+  cc = nil; result = callcc {|c| cc = c; block.call(cc) if block and args.empty?}
+  result ||= args
+  return *[cc, *result]
+end

data/lib/gems/facets-2.4.5/lib/lore/facets/date.rb

@@ -0,0 +1,396 @@
+require 'date'
+require 'facets/time/stamp'
+
+# = Date
+#
+# This new version of Date extension has been largely improved by
+# porting some of the methods used by ActiveSupport. The old version
+# already had much in common with the Active Support library, so it
+# was decided to take it a step further in that direction for the
+# sake of interoparability.
+#
+# Hopefully most of these methods will find there way into Ruby's
+# own standard library eventually.
+#
+# The biggest difference with ActiveSupport is the lack of many
+# of the "English-esque" methods, and that we use #stamp with
+# Date::FORMAT, instead of #to_formmated_s with Date::DATE_FORMATS.
+# We do not override the standard #to_s method like ActiveSupport does.
+
+class Date
+
+  FORMAT = {
+    :short        => "%e %b",
+    :long         => "%B %e, %Y",
+    :db           => "%Y-%m-%d",
+    :number       => "%Y%m%d",
+    :rfc822       => "%e %b %Y",
+    :default      => "%Y-%m-%d",
+    nil           => "%Y-%m-%d"
+  }
+
+  # Returns a new Date representing the date 1 day ago (i.e. yesterday's date).
+  def self.yesterday
+    ::Date.today.yesterday
+  end
+  
+  # Returns a new Date representing the date 1 day after today (i.e. tomorrow's date).
+  def self.tomorrow
+    ::Date.today.tomorrow
+  end
+  
+  # Returns Time.zone.today when config.time_zone is set, otherwise just returns Date.today.
+  def self.current
+    ::Time.zone_default ? ::Time.zone.today : ::Date.today
+  end
+
+  # A method to keep Time, Date and DateTime instances interchangeable
+  # on conversions. In this case, it simply returns +self+.
+  def to_date
+    self
+  end if RUBY_VERSION < '1.9'
+
+  # Converts a Date instance to a DateTime, where the time is set to the beginning of the day
+  # and UTC offset is set to 0.
+  #
+  # ==== Example:
+  #   date = Date.new(2007, 11, 10)  # => Sat, 10 Nov 2007
+  #
+  #   date.to_datetime               # => Sat, 10 Nov 2007 00:00:00 0000
+  def to_datetime
+    ::DateTime.civil(year, month, day, 0, 0, 0, 0)
+  end if RUBY_VERSION < '1.9'
+
+  # Converts a Date instance to a Time, where the time is set to the beginning of the day.
+  # The timezone can be either :local or :utc (default :local).
+  #
+  #   date = Date.new(2007, 11, 10)  # => Sat, 10 Nov 2007
+  #
+  #   date.to_time                   # => Sat Nov 10 00:00:00 0800 2007
+  #   date.to_time(:local)           # => Sat Nov 10 00:00:00 0800 2007
+  #
+  #   date.to_time(:utc)             # => Sat Nov 10 00:00:00 UTC 2007
+  #
+  def to_time(form=:local)
+    ::Time.send(form, year, month, day)
+    #::Time.send("#{form}_time", year, month, day)
+  end
+
+  def xmlschema
+    to_time.xmlschema
+  end
+
+  # Returns the number of days in the date's month.
+  #
+  #   Date.new(2004,2).days_in_month #=> 28
+  #
+  #  CREDIT: Ken Kunz.
+
+  def days_in_month
+     Date.civil(year, month, -1).day
+  end
+
+  def days_of_month
+    (1..days_in_month).to_a
+  end
+
+  # Get the month name for this date object
+  #
+  #  CREDIT Benjamin Oakes
+
+  def month_name
+    MONTHNAMES[self.month]
+  end
+
+  # Convert to a formatted string. See DATE_FORMATS for predefined formats.
+  #
+  # This method is aliased to <tt>to_s</tt>.
+  #
+  # ==== Examples:
+  #   date = Date.new(2007, 11, 10)       # => Sat, 10 Nov 2007
+  #
+  #   date.stamp(:db)            # => "2007-11-10"
+  #   date.stamp(:short)         # => "10 Nov"
+  #   date.stamp(:long)          # => "November 10, 2007"
+  #   date.stamp(:rfc822)        # => "10 Nov 2007"
+  #
+  # == Adding your own formats to stamp
+  # You can add your own formats to the Date::FORMAT hash.
+  # Use the format name as the hash key and a strftime string
+  # as the value. Eg.
+  #
+  #   Date::FORMAT[:month_and_year] = "%B %Y"
+  #
+  def stamp(format=:default)
+    if formatter = FORMAT[format]
+      strftime(formatter)
+    else
+      to_s
+    end
+  end
+
+  # Overrides the default inspect method with a human readable one, e.g., "Mon, 21 Feb 2005"
+  #def inspect
+  #  strftime("%a, %d %b %Y")
+  #end
+
+  # Provides precise Date calculations for years, months, and days.  The +options+ parameter takes a hash with 
+  # any of these keys: <tt>:years</tt>, <tt>:months</tt>, <tt>:weeks</tt>, <tt>:days</tt>.
+  def advance(options)
+    d = self
+    d = d >> options.delete(:years) * 12 if options[:years]
+    d = d >> options.delete(:months)     if options[:months]
+    d = d +  options.delete(:weeks) * 7  if options[:weeks]
+    d = d +  options.delete(:days)       if options[:days]
+    d
+  end
+
+  # Returns a new Date where one or more of the elements have been changed according to the +options+ parameter.
+  #
+  # Examples:
+  #
+  #   Date.new(2007, 5, 12).change(:day => 1)                  # => Date.new(2007, 5, 1)
+  #   Date.new(2007, 5, 12).change(:year => 2005, :month => 1) # => Date.new(2005, 1, 12)
+  def change(options)
+    ::Date.new(
+      options[:year]  || self.year,
+      options[:month] || self.month,
+      options[:day]   || self.day
+    )
+  end
+
+  # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
+  # and then subtracts the specified number of seconds
+  def ago(seconds)
+    to_time.since(-seconds)
+  end
+
+  # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
+  # and then adds the specified number of seconds
+  def since(seconds)
+    to_time.since(seconds)
+  end
+  alias :in :since
+
+  # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
+  def beginning_of_day
+    to_time
+  end
+  alias :midnight :beginning_of_day
+
+  # Convenience method which returns a new Date/DateTime representing the time 1 day ago
+  def yesterday
+    self - 1
+  end
+
+  # Convenience method which returns a new Date/DateTime representing the time 1 day since the instance time
+  def tomorrow
+    self + 1
+  end
+
+end
+
+
+class DateTime
+
+  #
+  def self.local_offset
+    ::Time.local(2007).utc_offset.to_r / 86400
+  end
+
+  # Converts self to a Ruby Date object; time portion is discarded
+  def to_date
+    ::Date.new(year, month, day)
+  end
+
+  # Attempts to convert self to a Ruby Time object; returns self if
+  # out of range of Ruby Time class, If self has an offset other than 0,
+  # self will just be returned unaltered, since there's no clean way
+  # to map it to a Time
+  def to_time
+    self.offset == 0 ? ::Time.utc_time(year, month, day, hour, min, sec) : self
+  end
+
+  # To be able to keep Times, Dates and DateTimes interchangeable on conversions
+  def to_datetime
+    self
+  end
+
+  # Convert to a formatted string. See Time::FORMAT for predefined formats.
+  # 
+  # This method is aliased to <tt>to_s</tt>.
+  # 
+  # === Examples:
+  #   datetime = DateTime.civil(2007, 12, 4, 0, 0, 0, 0)   # => Tue, 04 Dec 2007 00:00:00 +0000
+  # 
+  #   datetime.stamp(:db)            # => "2007-12-04 00:00:00"
+  #   datetime.stamp(:db)            # => "2007-12-04 00:00:00"
+  #   datetime.stamp(:number)        # => "20071204000000"
+  #   datetime.stamp(:short)         # => "04 Dec 00:00"
+  #   datetime.stamp(:long)          # => "December 04, 2007 00:00"
+  #   datetime.stamp(:rfc822)        # => "Tue, 04 Dec 2007 00:00:00 +0000"
+  #
+  # == Adding your own datetime formats to stamp
+  # DateTime formats are shared with Time. You can add your own to the
+  # Time::FORMAT hash. Use the format name as the hash key and
+  # a strftime string as the value. Eg.
+  #
+  #   Time::FORMAT[:month_and_year] = "%B %Y"
+  #
+  def stamp(format=:default)
+    if formatter = ::Time::FORMAT[format]
+      strftime(formatter)
+    else
+      to_s
+    end
+  end
+
+  # Seconds since midnight: DateTime.now.seconds_since_midnight
+  def seconds_since_midnight
+    self.sec + (self.min * 60) + (self.hour * 3600)
+  end
+
+  # Returns a new DateTime where one or more of the elements have been
+  # changed according to the +options+ parameter. The time options
+  # (hour, minute, sec) reset cascadingly, so if only the hour is 
+  # passed, then minute and sec is set to 0. If the hour and
+  # minute is passed, then sec is set to 0.
+  def change(options)
+    ::DateTime.civil(
+      options[:year]  || self.year,
+      options[:month] || self.month,
+      options[:day]   || self.day,
+      options[:hour]  || self.hour,
+      options[:min]   || (options[:hour] ? 0 : self.min),
+      options[:sec]   || ((options[:hour] || options[:min]) ? 0 : self.sec),
+      options[:offset]  || self.offset,
+      options[:start]  || self.start
+    )
+  end
+
+  # Uses Date to provide precise Time calculations for years, months, and days.
+  # The +options+ parameter takes a hash with any of these keys: <tt>:years</tt>,
+  # <tt>:months</tt>, <tt>:weeks</tt>, <tt>:days</tt>, <tt>:hours</tt>,
+  # <tt>:minutes</tt>, <tt>:seconds</tt>.
+  def advance(options)
+    d = to_date.advance(options)
+    datetime_advanced_by_date = change(:year => d.year, :month => d.month, :day => d.day)
+    seconds_to_advance = (options[:seconds] || 0) + (options[:minutes] || 0) * 60 + (options[:hours] || 0) * 3600
+    seconds_to_advance == 0 ? datetime_advanced_by_date : datetime_advanced_by_date.since(seconds_to_advance)
+  end
+
+  # Returns a new DateTime representing the time a number of seconds ago
+  # Do not use this method in combination with x.months, use months_ago instead!
+  def ago(seconds)
+    self.since(-seconds)
+  end
+
+  # Returns a new DateTime representing the time a number of seconds since the instance time
+  # Do not use this method in combination with x.months, use months_since instead!
+  def since(seconds)
+    self + Rational(seconds.round, 86400)
+  end
+  alias :in :since
+
+  # Returns a new DateTime representing the start of the day (0:00)
+  def beginning_of_day
+    change(:hour => 0)
+  end
+  alias :midnight :beginning_of_day
+
+  # Returns a new DateTime representing the end of the day (23:59:59)
+  def end_of_day
+    change(:hour => 23, :min => 59, :sec => 59)
+  end
+  
+  # Adjusts DateTime to UTC by adding its offset value; offset is set to 0
+  #
+  # Example:
+  #
+  #   DateTime.civil(2005, 2, 21, 10, 11, 12, Rational(-6, 24))       # => Mon, 21 Feb 2005 10:11:12 -0600
+  #   DateTime.civil(2005, 2, 21, 10, 11, 12, Rational(-6, 24)).utc   # => Mon, 21 Feb 2005 16:11:12 +0000
+  def utc
+    new_offset(0)
+  end
+  alias_method :getutc, :utc
+  
+  # Returns true if offset == 0
+  def utc?
+    offset == 0
+  end
+  
+  # Returns the offset value in seconds
+  def utc_offset
+    (offset * 86400).to_i
+  end
+
+  # Converts datetime to an appropriate format for use in XML
+  def xmlschema
+    strftime("%Y-%m-%dT%H:%M:%S%Z")
+  end if RUBY_VERSION < '1.9'
+
+  # Converts self to a floating-point number of seconds since the Unix epoch 
+  def to_f
+    days_since_unix_epoch = self - ::DateTime.civil(1970)
+    (days_since_unix_epoch * 86_400).to_f
+  end
+
+end
+
+
+class Time
+
+  public :to_date
+  public :to_datetime
+
+  # Converts a Time object to a Date, dropping hour, minute, and second precision.
+  #
+  #   my_time = Time.now  # => Mon Nov 12 22:59:51 -0500 2007
+  #   my_time.to_date     # => Mon, 12 Nov 2007
+  #
+  #   your_time = Time.parse("1/13/2009 1:13:03 P.M.")  # => Tue Jan 13 13:13:03 -0500 2009
+  #   your_time.to_date                                 # => Tue, 13 Jan 2009
+  def to_date
+    ::Date.new(year, month, day)
+  end
+
+  #  # Convert a Time to a Date. Time is a superset of Date.
+  #  # It is the year, month and day that are carried over.
+  #
+  #  def to_date
+  #    require 'date' # just in case
+  #    jd = Date.__send__(:civil_to_jd, year, mon, mday, Date::ITALY)
+  #    Date.new!(Date.__send__(:jd_to_ajd, jd, 0, 0), 0, Date::ITALY)
+  #  end
+
+
+  # Converts a Time instance to a Ruby DateTime instance, preserving UTC offset.
+  #
+  #   my_time = Time.now    # => Mon Nov 12 23:04:21 -0500 2007
+  #   my_time.to_datetime   # => Mon, 12 Nov 2007 23:04:21 -0500
+  #
+  #   your_time = Time.parse("1/13/2009 1:13:03 P.M.")  # => Tue Jan 13 13:13:03 -0500 2009
+  #   your_time.to_datetime                             # => Tue, 13 Jan 2009 13:13:03 -0500
+  def to_datetime
+    ::DateTime.civil(year, month, day, hour, min, sec, Rational(utc_offset, 86400))
+  end
+
+end
+
+
+class String
+
+  # Convert string to DateTime.
+  def to_datetime
+    date = ::Date._parse(self, false).values_at(:year, :mon, :mday, :hour, :min, :sec).map { |arg| arg || 0 }
+    ::DateTime.civil(*date)
+  end
+
+  # Parse data from string.
+  def to_date
+    #::Date::civil(*ParseDate.parsedate(self)[0..2])
+    ::Date.new(*::Date._parse(self, false).values_at(:year, :mon, :mday))
+  end
+
+end
+