Class: Date

Class

Date

In:

date.rb
date/format.rb
yaml/rubytypes.rb

Parent:

Class representing a date.

See the documentation to the file date.rb for an overview.

Internally, the date is represented as an Astronomical Julian Day Number, ajd. The Day of Calendar Reform, sg, is also stored, for conversions to other date formats. (There is also an of field for a time zone offset, but this is only for the use of the DateTime subclass.)

A new Date object is created using one of the object creation class methods named after the corresponding date format, and the arguments appropriate to that date format; for instance, Date::civil() (aliased to Date::new()) with year, month, and day-of-month, or Date::ordinal() with year and day-of-year. All of these object creation class methods also take the Day of Calendar Reform as an optional argument.

Date objects are immutable once created.

Once a Date has been created, date values can be retrieved for the different date formats supported using instance methods. For instance, mon() gives the Civil month, cwday() gives the Commercial day of the week, and yday() gives the Ordinal day of the year. Date values can be retrieved in any format, regardless of what format was used to create the Date instance.

The Date class includes the Comparable module, allowing date objects to be compared and sorted, ranges of dates to be created, and so forth.

Methods

+ - << <=> === >> _dump _load _parse _strptime ajd ajd_to_amjd ajd_to_jd amjd amjd_to_ajd asctime civil civil_to_jd commercial commercial_to_jd ctime cwday cweek cwyear day day_fraction day_fraction_to_time downto england eql? gregorian gregorian_leap? hash inspect italy jd jd jd_to_ajd jd_to_civil jd_to_commercial jd_to_ld jd_to_mjd jd_to_ordinal jd_to_wday julian julian_leap? ld ld_to_jd leap? mday mjd mjd_to_jd mon month new new_start next ns? ns? ordinal ordinal_to_jd os? os? parse start step strftime strptime succ time_to_day_fraction to_s to_yaml today upto valid_civil? valid_commercial? valid_jd? valid_ordinal? wday yday year zone_to_diff

Included Modules

Comparable

Constants

MONTHNAMES	=	[nil] + %w(January February March April May June July August September October November December)	Full month names, in English. Months count from 1 to 12; a month’s numerical representation indexed into this array gives the name of that month (hence the first element is nil).
DAYNAMES	=	%w(Sunday Monday Tuesday Wednesday Thursday Friday Saturday)	Full names of days of the week, in English. Days of the week count from 0 to 6 (except in the commercial week); a day’s numerical representation indexed into this array gives the name of that day.
ABBR_MONTHNAMES	=	[nil] + %w(Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec)	Abbreviated month names, in English.
ABBR_DAYNAMES	=	%w(Sun Mon Tue Wed Thu Fri Sat)	Abbreviated day names, in English.
ITALY	=	2299161	The Julian Day Number of the Day of Calendar Reform for Italy and the Catholic countries.
ENGLAND	=	2361222	The Julian Day Number of the Day of Calendar Reform for England and her Colonies.
JULIAN	=	false	A constant used to indicate that a Date should always use the Julian calendar.
GREGORIAN	=	true	A constant used to indicate that a Date should always use the Gregorian calendar.
MONTHS	=	{ 'january' => 1, 'february' => 2, 'march' => 3, 'april' => 4, 'may' => 5, 'june' => 6, 'july' => 7, 'august' => 8, 'september'=> 9, 'october' =>10, 'november' =>11, 'december' =>12
DAYS	=	{ 'sunday' => 0, 'monday' => 1, 'tuesday' => 2, 'wednesday'=> 3, 'thursday' => 4, 'friday' => 5, 'saturday' => 6
ABBR_MONTHS	=	{ 'jan' => 1, 'feb' => 2, 'mar' => 3, 'apr' => 4, 'may' => 5, 'jun' => 6, 'jul' => 7, 'aug' => 8, 'sep' => 9, 'oct' =>10, 'nov' =>11, 'dec' =>12
ABBR_DAYS	=	{ 'sun' => 0, 'mon' => 1, 'tue' => 2, 'wed' => 3, 'thu' => 4, 'fri' => 5, 'sat' => 6
ZONES	=	{ 'ut' => 03600, 'gmt' => 03600, 'est' => -53600, 'edt' => -43600, 'cst' => -63600, 'cdt' => -53600, 'mst' => -73600, 'mdt' => -63600, 'pst' => -83600, 'pdt' => -73600, 'a' => 13600, 'b' => 23600, 'c' => 33600, 'd' => 43600, 'e' => 53600, 'f' => 63600, 'g' => 73600, 'h' => 83600, 'i' => 93600, 'k' => 103600, 'l' => 113600, 'm' => 123600, 'n' => -13600, 'o' => -23600, 'p' => -33600, 'q' => -43600, 'r' => -53600, 's' => -63600, 't' => -73600, 'u' => -83600, 'v' => -93600, 'w' =>-103600, 'x' =>-113600, 'y' =>-123600, 'z' => 03600, 'utc' => 03600, 'wet' => 03600, 'bst' => 13600, 'wat' => -13600, 'at' => -23600, 'ast' => -43600, 'adt' => -33600, 'yst' => -93600, 'ydt' => -83600, 'hst' =>-103600, 'hdt' => -93600, 'cat' =>-103600, 'ahst'=>-103600, 'nt' =>-113600, 'idlw'=>-123600, 'cet' => 13600, 'met' => 13600, 'mewt'=> 13600, 'mest'=> 23600, 'mesz'=> 23600, 'swt' => 13600, 'sst' => 23600, 'fwt' => 13600, 'fst' => 23600, 'eet' => 23600, 'bt' => 33600, 'zp4' => 43600, 'zp5' => 53600, 'zp6' => 63600, 'wast'=> 73600, 'wadt'=> 83600, 'cct' => 83600, 'jst' => 93600, 'east'=> 103600, 'eadt'=> 113600, 'gst' => 103600, 'nzt' => 123600, 'nzst'=> 123600, 'nzdt'=> 133600, 'idle'=> 12*3600
PARSE_MONTHPAT	=	ABBR_MONTHS.keys.join('\|')
PARSE_DAYPAT	=	ABBR_DAYS. keys.join('\|')

External Aliases

gregorian_leap?	->	leap?
new	->	new0
valid_civil?	->	valid_date?
civil	->	new

Public Class methods

_load(str)

Load from Marshall format.

Ruby-Language API Docs and Resources

Methods

Included Modules

Constants

External Aliases

Public Class methods

Public Instance methods