summaryrefslogtreecommitdiff
path: root/ext/date/date_core.c
diff options
context:
space:
mode:
Diffstat (limited to 'ext/date/date_core.c')
-rw-r--r--ext/date/date_core.c44
1 files changed, 12 insertions, 32 deletions
diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index 3994e1a..99f1c0d 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -9234,41 +9234,30 @@ Init_date_core(void)
negative_inf = -INFINITY;
/*
- * The Date and DateTime classes provide methods for storing, comparing, transforming, and operating on values of date and time. Date objects store only the date (e.g. 1987-06-29), while DateTime objects store both the date and time (e.g. 1984-02-09 05:32:12).
+ * date and datetime class - Tadayoshi Funaba 1998-2011
*
- * 1998-2011 by Tadayoshi Funaba
- *
- * = Introduction
- *
- * Date and DateTime are included in the standard library. To use, require ‘date’ will provide both classes.
+ * 'date' provides two classes Date and DateTime.
*
* == Terms and definitions
*
* Some terms and definitions are based on ISO 8601 and JIS X 0301.
*
- * === Calendar date
+ * === calendar date
*
* The calendar date is a particular day of a calendar year,
* identified by its ordinal number within a calendar month within
* that year.
*
- * In the Date and DateTime classes, this is called "civil."
+ * In those classes, this is so-called "civil".
*
- * Date.civil(2012,03,17)
- * This refers to March 17th, 2012.
- *
- * === Ordinal date
+ * === ordinal date
*
* The ordinal date is a particular day of a calendar year identified
* by its ordinal number within the year.
*
- * In the Date and DateTime classes, this is called "ordinal."
- *
- * Date.ordinal(2012,77)
- * This refers to the 77th day of 2012.
+ * In those classes, this is so-called "ordinal".
*
- *
- * === Week date
+ * === week date
*
* The week date is a date identified by calendar week and day numbers.
*
@@ -9278,13 +9267,9 @@ Init_date_core(void)
* includes the first Thursday of that year. In the Gregorian
* calendar, this is equivalent to the week which includes January 4.
*
- * In the Date and DateTime classes, this is called "commercial."
- *
- * Date.commercial(2012,11,06)
- * This refers to the 6th day of the 11th week of 2012.
+ * In those classes, this so-called "commercial".
*
- *
- * === Julian day number
+ * === julian day number
*
* The Julian day number is in elapsed days since noon (Greenwich mean
* time) on January 1, 4713 BCE (in the Julian calendar).
@@ -9298,12 +9283,9 @@ Init_date_core(void)
* it just refers to "chronological Julian day number", not the
* original.
*
- * In the Date and DateTime classes, this is called "ajd" and "jd."
- *
- * Date.jd(2456004)
- * This refers to 2,456,004 days since January 1, 4713 BCE.
+ * In those classes, those are so-called "ajd" and "jd".
*
- * === Modified julian day number
+ * === modified julian day number
*
* The modified Julian day number is in elapsed days since midnight
* (Coordinated universal time) on November 17, 1858 CE (in the
@@ -9319,10 +9301,8 @@ Init_date_core(void)
* appears, it just refers to "chronological modified Julian day
* number", not the original.
*
- * In the Date and DateTime classes, this is called "mjd."
+ * In those classes, this is so-called "mjd".
*
- * Date.new(2012,03,17).mjd #=> 56003
- * 2012-03-17 is 56,003 days after November 17, 1858 CE.
*
* == Date
*