NAME

       stMktime, stWriteTime - date and time handling

SYNOPSIS

       #include <config.h>
       #include <sttk.h.h>

       time_tstMktime (char *string);

       char*stWriteTime (time_t date);

DESCRIPTION

       stMktime  scans the given string 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.

       [Tue] Jan 5[,] [19]93
                     This includes the standard asctime(3) format.

       Jan 5         With no year given, the year defaults to the current year.

       [19]93/01/05  This notation requires month and day represented by exactly two digits.

       5.1.[19]93    This is the usual German notation.

       5.1.          German notation referencing the current year.

       A certain time, given together with the date must always have the following form.

       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.

       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.

       stWriteTime generates a time string similar to asctime(3) from its date argument.

SEE ALSO

       asctime(3)

BUGS

       Time  Zone  Names  within  the  time string (like `MET') are not handled properly. In most
       cases they will cause a failure.