Man Linux: Main Page and Category List

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.