da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ie \\$3 .ft \\$1
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nr ;G \\n(.f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft \\n(;G \}
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EX \" start example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ta 1i 2i 3i 4i 5i 6i
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EE \" end example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chintm \- time conversion support
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH SYNOPSIS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "#include <tm.h>"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH DESCRIPTION
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibrary supports conversion between
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstring date specifications,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinclock values and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "struct tm"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L localtime()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L gmtime()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR ctime (3))
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare used to determine local time zone information.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinvalues are the number of seconds since the epoch,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR "Jan 1 00:00:00 GMT 1970" ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwith leap seconds omitted.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe global variable
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincontains flags that allow all programs using the library
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinto be controlled in a consistent manner.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis initialized by the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tminit()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinroutine described below, and may be explicitly reset after
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tminit()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe flags are:
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L TM_ADJUST
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tminit()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L localtime()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L gmtime()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindo not compensate for leap seconds.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinvalues are interpreted as if they include leap seconds.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tminit()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinoption is set in the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L TM_OPTIONS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinenvironment variable.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinTimes are relative to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(universal coordinated time, i.e.,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOtherwise times are relative to the local time zone.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tminit()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinif the time zone name matches one of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindescribed below.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinIf the time zone name is not determined by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L localtime()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen the environment variables
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(as described in BSD 4.3) and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(as described in System V)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare checked, in order.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinIf this fails then the time zone name is constructed using
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthe local time zone offset.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe routines are:
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "time_t tmdate(const char* date, char** end, time_t* clock)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinParses the date specification
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstring table (described below)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand returns the equivalent
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.RL non- NULL ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis set to the position of the first unrecognized character in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis used to provide default values for omitted components in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen the current time is used.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "struct tm* tmfix(struct tm* tp)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinCorrects any out of bounds fields in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand returns
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinas its value.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe corrections start with
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tp->tm_sec
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand propagate down to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tp->tm_year .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFor example, if
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tp->tm_sec
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwere 61 then it would change to 1 and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tp->tm_min
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwould be incremented by 1, and so on.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tp->tm_wday ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tp->tm_yday
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tp->tm_isdst
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare not changed as these can be computed from the other fields.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "char* tmfmt(char* buf, size_t len, const char* format, time_t* clock)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFormats the date pointed to by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chininto the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbytes according to the format specification
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR format .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinor empty then the string
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen the current time is used.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinA pointer to the end of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(i.e., the terminating
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR "'\e0'" )
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis returned.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis in the style of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR printf (3),
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BI % field
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincauses the corresponding fixed size field to be placed in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinzero padded if necessary, and \e\fIc\fP and \e\fInnn\fP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinsequences are interpreted as in the C language.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOtherwise invalid
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BI % field
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinspecifications and all other characters in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare copied into
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwithout change.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinString field values are taken from the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstring table.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinAbbreviated weekday name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFull weekday name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinAbbreviated month name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR ctime (3)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstyle date without the trailing
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR newline .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR date (1)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstyle date.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinDay of month number.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR mm / dd / yy .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinBlank padded day of month number.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinUnpadded day of month number.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinAbbreviated month name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin24-hour clock hour.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinInternational
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR date (1)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindate that includes the time zone type name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin12-hour clock hour.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin1-offset Julian date.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin0-offset Julian date.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindate that lists recent dates with
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR hh : mm
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand distant dates with
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinMonth number.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin12-hour time as
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR hh : mm : ss
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR meridian .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin24-hour time as
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR hh : mm .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin24-hour time as
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR hh : mm : ss .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinWeek number with Sunday as the first day.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinWeekday number.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinWeek number with Monday as the first day.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinLocal date style, using
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthat includes the month, day and year.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinLocal time style, using
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthat includes the hours and minutes.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin2-digit year.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin4-digit year.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinTime zone type name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinTime zone name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BI \- flag
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinTemporarily (until
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tmform()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinreturns) sets (+) or clears (\-) the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinflags specified by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinNumber of seconds since the epoch.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "void tminit(Tm_zone_t* zone)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinImplicitly called by the other
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibrary routines to initialize global data, including the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chintable and the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinglobal flags.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinGlobal data should only be modified after an explicit call to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tminit .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "zone != 0"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen it specifies a time zone other that the local time zone.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "void tmset(Tm_zone_t* zone);"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinsets the reference timezoe to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinpoints to the local timezone and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinpoints to the current reference timezone.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "time_t tmleap(time_t* clock)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinvalue for the time pointed to by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwith leap seconds adjusted for external
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinroutines that do not handle leap seconds.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen the current time is used.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinAdjustments are only done if the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L TM_ADJUST
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinflag is set in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "struct tm* tmmake(time_t* clock)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinReturns a pointer to the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstruct corresponding to the time pointed to by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR clock .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthen the current time is used.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "time_t tmtime(struct tm* tp, int west)"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinReturns the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinvalue corresponding to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L TM_LOCALZONE
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis relative to the local time zone,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis the number of minutes west of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinwith daylight savings time taken into account.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tp->tm_wday ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tp->tm_yday
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tp->tm_isdst
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare ignored in the conversion.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe library routines use a table of date strings pointed to by
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR "char** tm_info.format" .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe indices in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinare fixed by category.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmay be changed to point to other tables
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinaccording to local language and date conventions.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe contents by index (showing the USA English values) are:
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin3-character abbreviated month names.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFull month names.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin3-character abbreviated weekday names.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFull weekday names.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tmform()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlocal time format used by the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tmform()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlocal date format used by the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tmform()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinformat used if the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinargument is
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinMeridian names: AM, PM.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chintime zone names: GMT, UTC, UCT, CUT.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinDaylight savings time suffix names: DST.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinSuffixes to be ignored when matching strings in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR tmform() .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinTime part names: second, hour, minute, day, week, month, year.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinHours of the day names: midnight, morning, noon, evening.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinRelative day names: yesterday, today, tomorrow.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinPast relative time references: last, ago, past.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinCurrent relative time references: this, now, current.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFuture relative time references: next, hence, coming.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinExact relative time references: exactly.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinNoise words to be ignored: at, in, on.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinLow level support functions and data are described in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH EXAMPLES
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin char buf[128];
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin char* date;
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin char* format;
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "now", "%i",
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "2 months ago", "%C",
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "this Wednesday noon", "%x %I:%M %p",
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "last December 25", "%A",
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin for (i = 0; x[i].date; i++) {
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin t = tmdate(x[i].date, (char*)0, (time_t*)0);
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin (void)tmform(buf, x[i].format, &t);
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin puts(buf);
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFri Sep 30 12:10:14 USA EDT 1988
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFri Jul 1 00:00:00 EDT 1988
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin10/05/88 12:00 PM
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH "SEE ALSO"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindate(1), time(2), ctime(3)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "struct tm"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinvalues may get clobbered by the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibrary routines as the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR ctime (3)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinroutines typically return pointers to a single static
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "struct tm"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L tmdate()
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinuses an internal international time zone name table that will
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinprobably always be incomplete.