method
to_fs
v7.1.3.4 -
Show latest stable
-
0 notes -
Class: DateTime
- 1.0.0
- 1.1.6
- 1.2.6
- 2.0.3
- 2.1.0
- 2.2.1
- 2.3.8
- 3.0.0
- 3.0.9
- 3.1.0
- 3.2.1
- 3.2.8
- 3.2.13
- 4.0.2
- 4.1.8
- 4.2.1
- 4.2.7
- 4.2.9
- 5.0.0.1
- 5.1.7
- 5.2.3
- 6.0.0
- 6.1.3.1
- 6.1.7.7
- 7.0.0 (0)
- 7.1.3.2 (38)
- 7.1.3.4 (0)
- What's this?
to_fs(format = :default)
public
Convert to a formatted string. See Time::DATE_FORMATS for predefined formats.
This method is aliased to to_formatted_s.
Examples
datetime = DateTime.civil(2007, 12, 4, 0, 0, 0, 0) # => Tue, 04 Dec 2007 00:00:00 +0000 datetime.to_fs(:db) # => "2007-12-04 00:00:00" datetime.to_formatted_s(:db) # => "2007-12-04 00:00:00" datetime.to_fs(:number) # => "20071204000000" datetime.to_fs(:short) # => "04 Dec 00:00" datetime.to_fs(:long) # => "December 04, 2007 00:00" datetime.to_fs(:long_ordinal) # => "December 4th, 2007 00:00" datetime.to_fs(:rfc822) # => "Tue, 04 Dec 2007 00:00:00 +0000" datetime.to_fs(:iso8601) # => "2007-12-04T00:00:00+00:00"
Adding your own datetime formats to to_fs
DateTime formats are shared with Time. You can add your own to the Time::DATE_FORMATS hash. Use the format name as the hash key and either a strftime string or Proc instance that takes a time or datetime argument as the value.
# config/initializers/time_formats.rb Time::DATE_FORMATS[:month_and_year] = '%B %Y' Time::DATE_FORMATS[:short_ordinal] = lambda { |time| time.strftime("%B #{time.day.ordinalize}") }