Skip to content

DATE.md

Latest commit

 

History

History
84 lines (75 loc) · 3.77 KB

DATE.md

File metadata and controls

84 lines (75 loc) · 3.77 KB

Date

format

Converts a date object to strftime it using a human readable string.

Directive Type Key strftime Result
Weekday Monday w, weekday %u (1..7)
Weekday Sunday ww, weekday_offset %w (0..6)
Weekday Name www, weekday_name %A Sunday
Weekday Name abbr wwww, weekday_name_abbr %a Sun
Day Zero-padded d, day, day_padded %d (01..31)
Day Unpadded dd, Day, day_unpadded %-d (1..31)
Day Blank-padded ddd, DAY, day_blank %_d ( 1..31)
Day Day of the year dddd, day_of_the_year %j (001..366)
Month Zero-padded m, month, month_padded %m (01..12)
Month Unpadded mm, Month, month_unpadded %-m (1..12)
Month Blank-padded mmm, MONTH, day_blank %_m ( 1..12)
Month Name mmmm, month_name %B January
Month Name abbr mmmmm, month_name_abbr %b Jan
Week ISO we, week %V (00..53)
Week Monday mwe, monday_week %W (00..53)
Week Sunday swe, sunday_week %U (00..53)
Year 2 Digits yy, yr %y (00..99)
Year 4 Digits yyyy, year %Y 1999 
Date.today.format('month_name day, year') #=> 'May 05, 2000'

stamp aka to_format

Converts a date object to a predefined format.

Base

Directive Type Key strftime Result
Weekday Zero-padded :weekday, :weekday_padded %d (01..31)
Weekday Blank-padded :weekday_blank %_d ( 1..31)
Weekday Unpadded :weekday_unpadded %-d (1..31)
Weekday Name :weekday_name %A Sunday
Weekday Name abbr :weekday_name_abbr %a Sun
Month Zero-padded :month, :month_padded %m (01..12)
Month Unpadded :month_unpadded %-m (1..12)
Month Blank-padded :month_blank %_m ( 1..12)
Month Name :month_name %B January
Month Name abbr :month_name_abbr %b Jan
Week ISO :week_iso %V (00..53)
Week Sunday :week_sunday %U (00..53)
Week Monday :week_monday %W (00..53)
Year 2 Digits :yr, :year_abbr %y (00..99)
Year 4 Digits :year %Y 1999

Combinations

Directive Type Key strftime Result
Combo Month day :day %B %-d January 9
Combo Month day :day_abbr %b %-d Jan 9
Combo Month day :day_iso %m-%d 01-09
Combo Month year :month_year, :month_padded_year %m %Y (01..12) 2015
Combo Month year :month_blank_year %_m %Y ( 1..12) 2015
Combo Month year :month_unpadded_year %-m %Y (1..12) 2015
Combo Month year :month_name_year %B %Y January 2015
Combo Month year :month_name_abbr_year %b %Y Jan 2015
Combo Week year :week_year_iso %V-%G 04-2014
Combo Year day :year_day %Y-%m-%d 1999-01-21
Combo Year week :year_week %G-%V 1999-52
Combo Year month :year_month %Y-%m 1999-01
Combo Date :date %B %-d, %Y January 9, 2014
Combo Date :date_abbr %b %-d, %Y Jan 9, 2014
Combo Date :date_iso %Y-%m-%d 2014-01-09
Combo Day month day :day %A, %B %-d Sunday, January 9
Combo Day month day :day_abbr %a, %b %-d Sun, Jan 9
Combo Day month day :day_iso %a, %m-%d Sun, 01-09
Combo Day date :day_date %A, %B %-d, %Y Sunday, January 9, 2014
Combo Day date :day_date_abbr %a, %b %-d, %Y Sun, Jan 9, 2014
Combo Day date :day_date_iso %a, %Y-%m-%d Sun, 2014-01-09 
Date.today.to_format(:year) #=> '2014'