Guardian Native C Library Calls Reference Manual (G06.25+, H06.03+)

Guardian Native C Library Calls (g - i) getdate(3)
• When the input string contains no hour, no minutes, and no seconds, the getdate() func-
tion assumes the current hour, minute, and second.
• When the input string contains no date, the getdate( ) function assumes today if the given
hour is greater than the current hour and assumes tomorrow if it is less.
NOTES
The getdate() function uses the getdate_err external variable to return error values.
The getdate() function can be called by native processes only.
RETURN VALUES
On successful completion, the getdate() function returns a pointer to a struct tm which contains
the date/time information from the input string converted to the internal time format. Otherwise,
it returns a null pointer and sets the getdate_err variable to indicate the error.
ERRORS
If any of the following conditions occur, the getdate() function sets the getdate_err variable to
the corresponding value:
1 The DATEMSK environment variable was null or undefined.
2 The template file could not be opened for reading.
3 File status information could not be obtained.
4 The template file was not a regular file.
5 An error was encountered while reading the template file.
6 Memory allocation failed (not enough memory available).
7 The template file did not contain a line that matches the input string.
8 The input string contained invalid data.
FILES
DATEMSK Is an environment variable whose value is the full pathname of a template file. A
template file is a text file consisting of a series of lines, each of which defines an
acceptable date/time format using the field descriptors outlined in the
DESCRIPTION section.
STANDARDS CONFORMANCE
The getdate() function is defined in the XPG4 Version 2 specification.
527192-003 Hewlett-Packard Company 3−15