Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (g - i) getdate(3)
NAME
getdate - Converts user format date and time
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL
G-series native OSS processes: /G/system/sysnn/zstfnsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
H-series OSS processes: /G/system/zdllnnn/zcredll
SYNOPSIS
#include <time.h>
struct tm *getdate(const char *string);
extern int getdate_err;
PARAMETERS
string Is a pointer to a string containing date/time information.
DESCRIPTION
The getdate() function parses the date/time information in the input string pointed to by the
string parameter and returns a pointer to a struct tm.
To parse this string, the getdate() function uses templates stored in a text file whose full path-
name is the value for the DATEMSK environment variable. This file is searched one line at a
time until a template is found that matches the input string. The getdate() function uses this
template to interpret the input string and convert it to the internal time format.
The following field descriptors can be used in a template:
%A Matches a full weekday name.
%a Matches an abbreviated weekday name.
%B Matches a full month name.
%b Matches an abbreviated month name.
%c Matches an appropriate representation of the date and time for the current locale.
%D Matches a date in the form mm / dd / yy.
%d Matches a two-digit day of the month as a number (01 to 31; the leading 0 (zero)
is optional).
%e Is the same as %d.
%H Matches an hour in the 24-hour clock representation (00 to 23).
%h Matches an abbreviated month name.
%I Matches an hour in the 12-hour clock representation (01 to 12).
%M Matches the minutes (00 to 59).
%m Matches a month number (01 to 12).
%n Matches a newline character.
527192-007 Hewlett-Packard Company 3−13