Manpage  — GETDATE

getdate - Berechnet aus einer Zeichenkette eine struct tm

ÜBERSICHT BESCHREIBUNG RÜCKGABEWERT BEMERKUNGEN UMGEBUNG BEISPIEL KONFORM ZU SIEHE AUCH

#define _XOPEN_SOURCE
"#define _XOPEN_SOURCE_EXTENDED
#include <time.h>

struct tm *getdate (const char *string);

extern int getdate_err;

#define _GNU_SOURCE
#include <time.h>

int getdate_r (const char *string, struct tm *res);

Wenn die Funktion erfolgreich war, gibt sie einen Zeiger zu einem struct tm zurück. Ansonsten wird NULL zurückgegeben und die globale Variable getdate_err gesetzt. Änderungen an errno sind nicht spezifiziert. Die folgenden Werte für getdate_err sind definiert:

1	Die Umgebungsvariable DATEMSK ist NULL oder nicht definiert.
2	Die Datei konnte nicht gelesen werden.
3	Der Dateistatus konnte nicht ermittelt werden.
4	Die Datei ist keine reguläre Datei.
5	Es ist ein Lesefehler aufgetreten.
6	Es ist nicht ausreichend Speicher verfügbar.
7	Keine Zeile in der Datei paßt zur Zeichenkette.
8	Ungültige Eingabe wie z.B. 31 Februar oder eine Zeit die sich nicht als time_t dargestellen läßt (Sekunden seit 01.01.1970 00:00:00 UTC)

Da getdate() nicht reentrant ist, da getdate_err verwendt wird sowie ein statischer Speicherplatz als Rückgabewert genommen wird, bietet die glibc eine Thread-sichere Variante. Die Funktionalität ist die gleiche. Das Ergebnis wird ein einem Puffer zurückgegeben, auf den res zeigt. Im Fall eines Fehlers, ist der Rückgabewert nicht-null mit den gleichen Werten wie oben für getdate_err angegeben.

Die Spezifikation POSIX 1003.1-2001 für strptime() enthält Übersetzungs-Spezifikationen, die die Modifizierer %E und %O verwenden, während solche Spezifikationen nicht für getdate() angegeben sind. Die Implementierung von getdate() der glibc verwendet strptime(), so daß automatisch genau die gleiche Übersetzung von beiden unterstützt wird.

Die glibc-Implementierung unterstÜtzt die Übersetzungs-Spezifikation %Z nicht.

DATEMSK
	Datei, die Format-Muster enthält.
TZ, LC_TIME
	Variablen, die von strptime() verwendet werden.

Dieses Beispiel verdeutlicht die Anwendung, es ist nicht in der originalen Manpage enthalten.

#!/bin/sh
#
# sample script to create a file wirh possible
# date representations
#
cat >.date <<EOF
%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
EOF
DATEMSK=.date
export DATEMSK

#include <stdio.h>
#include <time.h>

void daterr(int err)
{
  switch(err) {
    case 1:  printf ("The DATEMSK environment variable is null or undefined.0);break;
    case 2:  printf ("The template file cannot be opened for reading.0);break;
    case 3:  printf ("Failed to get file status information.0);break;
    case 4:  printf ("The template file is not a regular file.0);break;
    case 5:  printf ("An error is encountered while reading the template file.0);break;
    case 6:  printf ("Memory allocation failed (not enough memory available.0);break;
    case 7:  printf ("There is no line in the template that matches the input.0);break;
    case 8:  printf ("Invalid input specification0);break;
    default: printf ("unknown error0);
  }
  exit(1);
}

int main()
{
  struct tm *tm;
  char buf[512];

  tm = getdate ("11/27/86");

  if (getdate_err != 0) daterr (getdate_err);

  strftime (buf, sizeof (buf)/sizeof (buf[0]), "%a %Y %H:%M:%S0,tm);
  printf ("%s", buf);
}

ISO 9899, POSIX 1003.1-2001