Note normalizing behavior of mktime(3) using language from FreeBSD.

This commit is contained in:
jschauma 2022-10-21 03:05:15 +00:00
parent eff9c5831e
commit 61d8e1efc0
1 changed files with 13 additions and 3 deletions

View File

@ -1,8 +1,8 @@
.\" $NetBSD: ctime.3,v 1.63 2022/08/16 11:07:40 christos Exp $
.\" $NetBSD: ctime.3,v 1.64 2022/10/21 03:05:15 jschauma Exp $
.\"
.\" XXX: License missing?
.\"
.Dd August 16, 2022
.Dd October 22, 2022
.Dt CTIME 3
.Os
.Sh NAME
@ -253,7 +253,17 @@ 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.
to their normal ranges and will be normalized,
if need be.
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