Skip to content

Commit

Permalink
remove redundant text about the standard calendar, clarify the deprec…
Browse files Browse the repository at this point in the history
…ation of year and month units
  • Loading branch information
JonathanGregory committed Jul 2, 2021
1 parent 41b1a88 commit bd7498d
Showing 1 changed file with 2 additions and 28 deletions.
30 changes: 2 additions & 28 deletions ch04.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -210,11 +210,9 @@ and minutes)."

The acceptable units for time are listed in the UDUNITS database. The most commonly used of these strings (and their abbreviations) includes **`day`** (**`d`**), **`hour`** (**`hr`**, **`h`**), **`minute`** (**`min`**) and **`second`** (**`sec`**, **`s`**). Plural forms are also acceptable.

The reference date/time string (appearing after the identifier **`since`**) may include date alone, or date and time, or date, time and time zone. The reference date/time string is required. If the time zone is omitted the default is UTC, and if both time and time zone are omitted the default is 00:00:00 UTC.
The reference date/time string (appearing after the identifier **`since`**) is required. It may include date alone, or date and time, or date, time and time zone. If the time zone is omitted the default is UTC, and if both time and time zone are omitted the default is 00:00:00 UTC.

We recommend that the unit **`year`** be used with caution. The Udunits package defines a **`year`** to be exactly 365.242198781 days (the interval between 2 successive passages of the sun through vernal equinox). __It is not a calendar year.__ Udunits includes the following definitions for years: a **`common_year`** is 365 days, a **`leap_year`** is 366 days, a **`Julian_year`** is 365.25 days, and a **`Gregorian_year`** is 365.2425 days.

For similar reasons the unit **`month`**, which is defined in link:$$http://www.unidata.ucar.edu/software/udunits/$$[`udunits.dat`] to be exactly **`year/12`**, should also be used with caution.
UDUNITS defines a **`year`** to be exactly 365.242198781 days (the interval between 2 successive passages of the sun through vernal equinox). __It is not a calendar year.__ UDUNITS defines a **`month`** to be exactly **`year/12`**, which is __not a calendar month__. The CF standard follows UDUNITS in the definition of units, but we recommend that **`year`** and **`month`** should not be used, because of the potential for mistakes and confusion.

[[time-axis-ex]]
[caption="Example 4.4. "]
Expand Down Expand Up @@ -330,30 +328,6 @@ double time(time) ;
====

The mixed Gregorian/Julian calendar used by Udunits is explained in the following excerpt from the udunits(3) man page:
----
The udunits(3) package uses a mixed Gregorian/Julian calen-
dar system. Dates prior to 1582-10-15 are assumed to use
the Julian calendar, which was introduced by Julius Caesar
in 46 BCE and is based on a year that is exactly 365.25 days
long. Dates on and after 1582-10-15 are assumed to use the
Gregorian calendar, which was introduced on that date and is
based on a year that is exactly 365.2425 days long. (A year
is actually approximately 365.242198781 days long.) Seem-
ingly strange behavior of the udunits(3) package can result
if a user-given time interval includes the changeover date.
For example, utCalendar() and utInvCalendar() can be used to
show that 1582-10-15 *preceded* 1582-10-14 by 9 days.
----



Due to problems caused by the discontinuity in the default mixed Gregorian/Julian calendar, we strongly recommend that this calendar should only be used when the time coordinate does not cross the discontinuity. For time coordinates that do cross the discontinuity the **`proleptic_gregorian`** calendar should be used instead.




[[discrete-axis, Section 4.5, "Discrete Axis"]]
=== Discrete Axis
Expand Down

0 comments on commit bd7498d

Please sign in to comment.