Ruby » Ruby master

*

* Date.valid_jd?(2451944) #=> true

*

*/

static VALUE

date_s_valid_jd_p(int argc, VALUE *argv, VALUE klass)

* Date.valid_date?(2001,2,3) #=> true

* Date.valid_date?(2001,2,29) #=> false

*

*/

static VALUE

date_s_valid_civil_p(int argc, VALUE *argv, VALUE klass)

* Date.valid_ordinal?(2001,34) #=> true

* Date.valid_ordinal?(2001,366) #=> false

*

*/

static VALUE

date_s_valid_ordinal_p(int argc, VALUE *argv, VALUE klass)

* Date.valid_commercial?(2001,5,6) #=> true

* Date.valid_commercial?(2001,5,8) #=> false

*

*/

static VALUE

date_s_valid_commercial_p(int argc, VALUE *argv, VALUE klass)

* Date.jd(2451945) #=> #<Date: 2001-02-04 ...>

* Date.jd(0) #=> #<Date: -4712-01-01 ...>

*

*/

static VALUE

date_s_jd(int argc, VALUE *argv, VALUE klass)

* Date.ordinal(2001,34) #=> #<Date: 2001-02-03 ...>

* Date.ordinal(2001,-1) #=> #<Date: 2001-12-31 ...>

*

*/

static VALUE

date_s_ordinal(int argc, VALUE *argv, VALUE klass)

* Date.new(2001,2,3) #=> #<Date: 2001-02-03 ...>

* Date.new(2001,2,-1) #=> #<Date: 2001-02-28 ...>

*

*/

static VALUE

date_s_civil(int argc, VALUE *argv, VALUE klass)

* Date.commercial(2002) #=> #<Date: 2001-12-31 ...>

* Date.commercial(2001,5,6) #=> #<Date: 2001-02-03 ...>

*

*/

static VALUE

date_s_commercial(int argc, VALUE *argv, VALUE klass)

* call-seq:

* Date.today([start=Date::ITALY]) -> date

*

* Creates a date object denoting the present day.

*/

static VALUE

date_s_today(int argc, VALUE *argv, VALUE klass)

* Date._strptime('2001-02-03', '%Y-%m-%d')

* #=> {:year=>2001, :mon=>2, :mday=>3}

*

*/

static VALUE

date_s__strptime(int argc, VALUE *argv, VALUE klass)

/*

* call-seq:

*

* Parses the given representation of date and time with the given

* template, and creates a date object. strptime does not support

* Date.strptime('2001 05 6', '%Y %W %u') #=> #<Date: 2001-02-03 ...>

* Date.strptime('sat3feb01', '%a%d%b%y') #=> #<Date: 2001-02-03 ...>

*

*/

static VALUE

date_s_strptime(int argc, VALUE *argv, VALUE klass)

/*

* call-seq:

*

* Parses the given representation of date and time, and creates a

* date object. This method does not function as a validator.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some typical ISO 8601 formats.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some typical RFC 3339 formats.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some typical XML Schema formats.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some typical RFC 2822 formats.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some RFC 2616 format.

/*

* call-seq:

*

* Creates a new Date object by parsing from a string according to

* some typical JIS X 0301 formats.

* call-seq:

* d.new_start([start=Date::ITALY]) -> date

*

*

* d = Date.new(1582,10,15)

* d.new_start(Date::JULIAN) #=> #<Date: 1582-10-05 ...>

* call-seq:

* d + other -> date

*

*

* Date.new(2001,2,3) + 1 #=> #<Date: 2001-02-04 ...>

* DateTime.new(2001,2,3) + Rational(1,2)

*

* Returns the difference between the two dates if the other is a date

* object. If the other is a numeric value, returns a date object

*

* Date.new(2001,2,3) - 1 #=> #<Date: 2001-02-02 ...>

* DateTime.new(2001,2,3) - Rational(1,2)

* call-seq:

* d >> n -> date

*

*

*/

static VALUE

d_lite_rshift(VALUE self, VALUE other)

* call-seq:

* d << n -> date

*

*

*/

static VALUE

d_lite_lshift(VALUE self, VALUE other)

* call-seq:

* d.next_month([n=1]) -> date

*

*/

static VALUE

d_lite_next_month(int argc, VALUE *argv, VALUE self)

* call-seq:

* d.prev_month([n=1]) -> date

*

*/

static VALUE

d_lite_prev_month(int argc, VALUE *argv, VALUE self)

* call-seq:

* d.next_year([n=1]) -> date

*

*/

static VALUE

d_lite_next_year(int argc, VALUE *argv, VALUE self)

* call-seq:

* d.prev_year([n=1]) -> date

*

*/

static VALUE

d_lite_prev_year(int argc, VALUE *argv, VALUE self)

* should be a date object or a numeric value as an astronomical

* Julian day number.

*

*

* See also Comparable.

*/

* call-seq:

* d.to_s -> string

*

*

* Date.new(2001,2,3).to_s #=> "2001-02-03"

*/

*

* Formats date according to the directives in the given format

* string.

* Any text not listed as a directive will be passed through to the

* output string.

*

* %T - 24-hour time (%H:%M:%S)

* %+ - date(1) (%a %b %e %H:%M:%S %Z %Y)

*

* Several directives (%a, %A, %b, %B, %c, %p, %r, %x, %X, %E*, %O* and %Z)

* are locale dependent in the function.

* systems such as C.

* It is good practice to avoid %x and %X because there are corresponding

* locale independent representations, %D and %T.

* %GW%V%uT%H%M%z => 2007W471T0837-0600 Week date and local time and difference from UTC (basic)

* %G-W%V-%uT%R%:z => 2007-W47-1T08:37-06:00 Week date and local time and difference from UTC (extended)

*

*/

static VALUE

d_lite_strftime(int argc, VALUE *argv, VALUE self)

* call-seq:

* DateTime.jd([jd=0[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]) -> datetime

*

* day number.

*

* DateTime.jd(2451944) #=> #<DateTime: 2001-02-03T00:00:00+00:00 ...>

* call-seq:

* DateTime.ordinal([year=-4712[, yday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]) -> datetime

*

*

* DateTime.ordinal(2001,34) #=> #<DateTime: 2001-02-03T00:00:00+00:00 ...>

* DateTime.ordinal(2001,34,4,5,6,'+7')

* DateTime.civil([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]]) -> datetime

* DateTime.new([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]]) -> datetime

*

*

* DateTime.new(2001,2,3) #=> #<DateTime: 2001-02-03T00:00:00+00:00 ...>

* DateTime.new(2001,2,3,4,5,6,'+7')

* call-seq:

* DateTime.commercial([cwyear=-4712[, cweek=1[, cwday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]]) -> datetime

*

*

* DateTime.commercial(2001) #=> #<DateTime: 2001-01-01T00:00:00+00:00 ...>

* DateTime.commercial(2002) #=> #<DateTime: 2001-12-31T00:00:00+00:00 ...>

* call-seq:

* DateTime.now([start=Date::ITALY]) -> datetime

*

*

* DateTime.now #=> #<DateTime: 2011-06-11T21:20:44+09:00 ...>

*/

* template, and returns a hash of parsed elements. _strptime does

* not support specification of flags and width unlike strftime.

*

*/

static VALUE

datetime_s__strptime(int argc, VALUE *argv, VALUE klass)

/*

* call-seq:

*

* Parses the given representation of date and time with the given

* specification of flags and width unlike strftime.

*

* DateTime.strptime('2001-02-03T04:05:06+07:00', '%Y-%m-%dT%H:%M:%S%z')

* DateTime.strptime('sat3feb014pm+7', '%a%d%b%y%H%p%z')

* #=> #<DateTime: 2001-02-03T16:00:00+07:00 ...>

*

*/

static VALUE

datetime_s_strptime(int argc, VALUE *argv, VALUE klass)

/*

* call-seq:

*

* Parses the given representation of date and time, and creates a

*

* If the optional second argument is true and the detected year is in

* the range "00" to "99", makes it full.

/*

* call-seq:

*

* some typical ISO 8601 formats.

*

* DateTime.iso8601('2001-02-03T04:05:06+07:00')

/*

* call-seq:

*

* some typical RFC 3339 formats.

*

* DateTime.rfc3339('2001-02-03T04:05:06+07:00')

/*

* call-seq:

*

* some typical XML Schema formats.

*

* DateTime.xmlschema('2001-02-03T04:05:06+07:00')

/*

* call-seq:

*

* some typical RFC 2822 formats.

*

* DateTime.rfc2822('Sat, 3 Feb 2001 04:05:06 +0700')

/*

* call-seq:

*

* some RFC 2616 format.

*

* DateTime.httpdate('Sat, 03 Feb 2001 04:05:06 GMT')

/*

* call-seq:

*

* some typical JIS X 0301 formats.

*

* DateTime.jisx0301('H13.02.03T04:05:06+07:00')

* call-seq:

* dt.to_s -> string

*

*

* DateTime.new(2001,2,3,4,5,6,'-7').to_s

* #=> "2001-02-03T04:05:06-07:00"

*

* Formats date according to the directives in the given format

* string.

* Any text not listed as a directive will be passed through to the

* output string.

*

*

* The minimum field width specifies the minimum width.

*

* They are ignored.

*

* Format directives:

* %T - 24-hour time (%H:%M:%S)

* %+ - date(1) (%a %b %e %H:%M:%S %Z %Y)

*

* Several directives (%a, %A, %b, %B, %c, %p, %r, %x, %X, %E*, %O* and %Z)

* are locale dependent in the function.

* systems such as C.

* It is good practice to avoid %x and %X because there are corresponding

* locale independent representations, %D and %T.

* %GW%V%uT%H%M%z => 2007W471T0837-0600 Week date and local time and difference from UTC (basic)

* %G-W%V-%uT%R%:z => 2007-W47-1T08:37-06:00 Week date and local time and difference from UTC (extended)

*

*/

static VALUE

dt_lite_strftime(int argc, VALUE *argv, VALUE self)

* dt.xmlschema([n=0]) -> string

*

* This method is equivalent to strftime('%FT%T'). The optional

*

* DateTime.parse('2001-02-03T04:05:06.123456789+07:00').iso8601(9)

* #=> "2001-02-03T04:05:06.123456789+07:00"

/*

* date and datetime class - Tadayoshi Funaba 1998-2011

*

*

*

* Some terms and definitions are based on ISO 8601 and JIS X 0301.

*

*

* The calendar date is a particular day of a calendar year,

* identified by its ordinal number within a calendar month within

*

* In those classes, this is so-called "civil".

*

*

* The ordinal date is a particular day of a calendar year identified

* by its ordinal number within the year.

*

* In those classes, this is so-called "ordinal".

*

*

* The week date is a date identified by calendar week and day numbers.

*

* includes the first Thursday of that year. In the Gregorian

* calendar, this is equivalent to the week which includes January 4.

*

*

*

*

* number is a variation of the Julian day number. Its days begin at

* midnight on local time.

*

*

* In those classes, those are so-called "ajd" and "jd".

*

*

* The modified Julian day number is in elapsed days since midnight

* Gregorian calendar).

*

* In this document, the astronomical modified Julian day number is

* chronological modified Julian day number is a variation of the

* modified Julian day number. Its days begin at midnight on local

* time.

* appears, it just refers to "chronological modified Julian day

* number", not the original.

*

*

* == Date

*

*

* Date::commercial, Date::parse, Date::strptime, Date::today,

*

* require 'date'

*

*

* All date objects are immutable; hence cannot modify themselves.

*

* of the day count, the offset and the day of calendar reform.

*

* The day count denotes the absolute position of a temporal

* The offset in this class is usually zero, and cannot be

* specified directly.

*

*

* $ ruby sample/cal.rb -c it 10 1582

* October 1582

* 17 18 19 20 21 22 23

* 24 25 26 27 28 29 30

*

*

* d = Date.parse('3rd Feb 2001')

* #=> #<Date: 2001-02-03 ...>

rb_define_const(cDate, "ENGLAND", INT2FIX(ENGLAND));

/* The Julian day number of the day of calendar reform for the

*/

rb_define_const(cDate, "JULIAN", DBL2NUM(JULIAN));

/* The Julian day number of the day of calendar reform for the

*/

rb_define_const(cDate, "GREGORIAN", DBL2NUM(GREGORIAN));

/*

* == DateTime

*

*

* DateTime does not consider any leap seconds, does not track

* any summer time rules.

*

* DateTime::ordinal, DateTime::commercial, DateTime::parse,

*

* require 'date'

*

* DateTime.new(2001,2,3,4,5,6)

* #=> #<DateTime: 2001-02-03T04:05:06+00:00 ...>

*

* fractional number. The fractional number's precision is assumed

* at most nanosecond.

*

* DateTime.new(2001,2,3.5)

* #=> #<DateTime: 2001-02-03T12:00:00+00:00 ...>

*

* between the local time and UTC. For example, <tt>Rational(3,24)</tt>

* represents ahead of 3 hours of UTC, <tt>Rational(-5,24)</tt> represents

* behind of 5 hours of UTC. The offset should be -1 to +1, and

* its precision is assumed at most second. The default value is

*

* DateTime.new(2001,2,3,4,5,6,Rational(3,24))

* #=> #<DateTime: 2001-02-03T04:05:06+03:00 ...>

*

*

* DateTime.new(2001,2,3,4,5,6,'+03:00')

* #=> #<DateTime: 2001-02-03T04:05:06+03:00 ...>

*

* a Julian day number, which should be 2298874 to 2426355 or

*

*

* d = DateTime.parse('3rd Feb 2001 04:05:06+03:30')

* #=> #<DateTime: 2001-02-03T04:05:06+03:30 ...>

* died on the same day in history -

* so much so that UNESCO named April 23 as

* {World Book Day because of this fact}[http://en.wikipedia.org/wiki/World_Book_Day].

* {Gregorian Calendar Reform}[http://en.wikipedia.org/wiki/Gregorian_calendar#Gregorian_reform]

* (and wouldn't until {1752}[http://en.wikipedia.org/wiki/Calendar_(New_Style)_Act_1750])

* their deaths are actually 10 days apart.

* Since Ruby's Time class implements a

* {proleptic Gregorian calendar}[http://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar]

*

* shakespeare = DateTime.iso8601('1616-04-23', Date::ENGLAND)

* #=> Tue, 23 Apr 1616 00:00:00 +0000

* cervantes = DateTime.iso8601('1616-04-23', Date::ITALY)

* #=> Sat, 23 Apr 1616 00:00:00 +0000

*

*

* cervantes == shakespeare

* #=> false