.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: sttime.3[4.0] Thu Jun 24 17:43:35 1993 andy@cs.tu-berlin.de frozen $
..
.TH sttime 3 "Thu Jun 24 17:43:35 1993" "sttk-1.7" "ShapeTools Toolkit Library"
.SH NAME
stMktime, stWriteTime \- date and time handling
.SH SYNOPSIS
#include <config.h>
.br
#include <sttk.h.h>
.sp
.ta 1.2c
time_t	stMktime (char *string);
.sp
char*	stWriteTime (time_t date);
.sp
.SH DESCRIPTION
\fIstMktime\fP scans the given \fIstring\fP and tries to read a date
and time from it. It understands various formats of date strings. The
following is a list of all valid formats, optional parts in brackets.
.TP 3.5c
[Tue] Jan 5[,] [19]93
This includes the standard asctime(3) format.
.TP
Jan 5
With no year given, the year defaults to the current year.
.TP
[19]93/01/05
This notation requires month and day represented by exactly two digits.
.TP
5.1.[19]93
This is the usual German notation.
.TP
5.1.
German notation referencing the current year.
.LP
A certain time, given together with the date must always have the
following form.
.TP 4c
hours:minutes[:seconds]
Each of the fields must be an integer value within the proper range
(hours: 0-23, minutes and seconds: 0-59). Values below 10 may be
written as one digit numbers.
.LP
The time value may be placed anywhere in the date string: at the
beginning, at the end, or somewhere in the middle. Any amount of
whitespace may be given between a field of the time value and the
separating colon. The time is always considered to be local time.
.LP
\fIstWriteTime\fP generates a time string similar to asctime(3) from
its \fIdate\fP argument.
.SH SEE ALSO
asctime(3)
.SH BUGS
Time Zone Names within the time string (like `MET') are not handled
properly. In most cases they will cause a failure.