Class | DateTime |
In: |
lib/more/facets/date.rb
|
Parent: | Object |
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.
Convert to a formatted string. See Time::FORMAT for predefined formats.
This method is aliased to to_s.
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"
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"
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