GETDATE(3) | Library Functions Manual | GETDATE(3) |
getdate
, getdate_err
—
#include <time.h>
struct tm *
getdate
(const char *str);
extern int getdate_err;
getdate
() function converts a date or time character
string pointed to by str into a static
tm structure described in
tm(3).
The input string is parsed and interpreted using templates. A text
file containing templates is specified by the environment variable
DATEMSK
. This should contain the full path to the
template file. Lines in the template file represent acceptable date and/or
time conversion specifications. These specifications are similar to those
given for strptime(3). The
first line in the template file that matches the input string is used to
interpret and convert to internal time format.
%Z
is being scanned, then the broken-down time
is based on the current time of the matched timezone and not the current
runtime environment timezone.getdate
() function returns a pointer
to a static tm structure containing the broken-down
time. Otherwise, a null pointer is returned and
getdate_err is set to indicate the error.
The variable getdate_err can have the following values:
DATEMSK
environment variable is null or undefined.DATEMSK
DATEMSK
environment variable.%m %A %B %d, %Y, %H:%M:%S %A %B %m/%d/%y %I %p %d,%m,%Y %H:%M at %A the %dst of %B in %Y run job at %I %p, %B %dnd %A den %d. %B %Y %H.%M Uhr
The following are examples of valid input for the above template:
10/1/87 4 PM Friday Friday September 18, 1987, 10:30:30 24,9,1986 10:30 at monday the 1st of december in 1986 run job at 3 PM, december 2nd
The following examples show how local data and time specification can be defined in the template.
Input String | Line in Template |
11/27/86 |
%m/%d/%y |
27.11.86 |
%d.%m.%y |
86-11-27 |
%y-%m-%d |
Friday
12:00:00 |
%A
%H:%M:%S |
The following examples illustrate the Internal Format Conversion
rules given that the current date is Mon Sep 22 12:19:47
EDT 1986
and the LC_TIME
environment variable
is set to the default C locale.
getdate
() function conforms to IEEE
Std 1003.1-2001 (“POSIX.1”).
getdate
function appeared in
AT&T System V Release 4 UNIX.
getdate
interface is inherently unsafe for
multi-threaded programs or libraries, since it returns a pointer to a static
variable and uses a global state variable.
February 7, 2018 | NetBSD 9.2 |