# HG changeset patch # User Richard M. Stallman # Date 838179836 0 # Node ID c96cee4f8be8d4f9308c65f5285703bd045f3cbe # Parent d6eb0b865cd222a004936fbec3370c40ca455f46 Explain range of time values, and what negative year numbers mean. diff -r d6eb0b865cd2 -r c96cee4f8be8 lispref/os.texi --- a/lispref/os.texi Wed Jul 24 03:38:46 1996 +0000 +++ b/lispref/os.texi Wed Jul 24 03:43:56 1996 +0000 @@ -907,6 +907,18 @@ values from the functions @code{current-time} (@pxref{Time of Day}) and @code{file-attributes} (@pxref{File Attributes}). +Many operating systems are limited to time values that contain 32 bits +of information; these systems typically handle only the times from +1901-12-13 20:45:52 UTC through 2038-01-19 03:14:07 UTC. However, some +operating systems have larger time values, and can represent times far +in the past or future. + +Time conversion functions always use the Gregorian calendar, even for +dates before the Gregorian calendar was introduced. Year numbers count +the number of years since the year 1 B.C., and do not skip zero as +traditional Gregorian years do; for example, the year number -37 +represents the Gregorian year 38 B.C@. + @defun format-time-string format-string time This function converts @var{time} to a string according to @var{format-string}. The argument @var{format-string} may contain