summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-06-23 08:57:40 +0000
committerru <ru@FreeBSD.org>2001-06-23 08:57:40 +0000
commit91931fd332af9d86e838cd4714ce100046a16818 (patch)
treed093019c1aacd1ae363dad50ad0bcb5959d5d419 /lib/libc
parentd9a8a794a66c0de3894b2b484f6bfe2eab6df5a8 (diff)
downloadFreeBSD-src-91931fd332af9d86e838cd4714ce100046a16818.zip
FreeBSD-src-91931fd332af9d86e838cd4714ce100046a16818.tar.gz
Document "normalizing" behavior of mktime(3).
PR: bin/28313 Reviewed by: bde, wollman MFC after: 1 week
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/stdtime/ctime.313
1 files changed, 12 insertions, 1 deletions
diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3
index 989db25..94f0622 100644
--- a/lib/libc/stdtime/ctime.3
+++ b/lib/libc/stdtime/ctime.3
@@ -196,7 +196,18 @@ The original values of the
and
.Fa tm_yday
components of the structure are ignored, and the original values of the
-other components are not restricted to their normal ranges.
+other components are not restricted to their normal ranges, and will be
+normalized if needed.
+For example,
+October 40 is changed into November 9,
+a
+.Fa tm_hour
+of \-1 means 1 hour before midnight,
+.Fa tm_mday
+of 0 means the day preceding the current month, and
+.Fa tm_mon
+of \-2 means 2 months before January of
+.Fa tm_year .
(A positive or zero value for
.Fa tm_isdst
causes
OpenPOWER on IntegriCloud