| 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.DATEMSKDATEMSK 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.4 |