Freigeben über


_get_tzname

Ruft die Zeichenfolgendarstellung des Zeitzonennamens oder des Tageslicht-Normalzeit-Zonennamens ab (DST).

errno_t _get_tzname(
    size_t* pReturnValue,
    char* timeZoneName,
    size_t sizeInBytes,
    int index    
);

Parameter

  • [out] pReturnValue
    Die Zeichenfolgenlänge von timeZoneName einschließlich einen Nullterminator.

  • [out] timeZoneName
    Die Adresse einer Zeichenfolge für die Darstellung des Zeitzonennamens oder des Tageslicht-Normalzeit-Zonennamens (DST), je nach index.

  • [in] sizeInBytes
    Die Größe der Zeichenfolge timeZoneName in Bytes.

  • [in] index
    Der Index von einem der beiden Zeitzonennamen abzurufen.

Rückgabewert

Null wenn erfolgreich; andernfalls ein errno-Typwert.

Wenn entweder timeZoneName ist NULL oder sizeInBytes einmal oder kleiner als null (jedoch nicht beide) ist, wird ein ungültiger Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, legt diese Funktion errno auf EINVAL fest und gibt EINVAL zurück.

Fehlerbedingungen

pReturnValue

timeZoneName

sizeInBytes

index

Rückgabewert

Inhalt von timeZoneName

Größe von TZ-Namen

NULL

0

0 oder 1

0

nicht geändert

Größe von TZ-Namen

any

> 0

0 oder 1

0

TZ-Name

nicht geändert

NULL

> 0

any

EINVAL

nicht geändert

nicht geändert

any

0 (Null)

any

EINVAL

nicht geändert

nicht geändert

any

> 0

> 1

EINVAL

nicht geändert

Hinweise

Die _get_tzname-Funktion ruft die Zeichenfolgendarstellung des Zeitzonennamens oder des Tageslicht-Normalzeit-Zonennamens (DST) in die Adresse von timeZoneName abhängig von dem Indexwert, zusammen mit der Größe der Zeichenfolge in pReturnValue ab. Wenn timeZoneNameNULL und sizeInBytes gleich ist, nur wird die Größe der Zeichenfolge der Zeitzone in Bytes in pReturnValue zurückgegeben. Die Indexwerte müssen entweder 0 für Normalzeit-Zone oder 1 für Tageslicht-Normalzeit-Zone sein; alle anderen Werte des Index verfügen unbestimmte Ergebnisse.

Indexwerte

index

Inhalt von timeZoneName

timeZoneName Standardwerte

0

Zeitzonenname

"PST"

1

Tageslicht-Normalzeit-Zonenname

"PDT"

> 1 oder < 0

errno auf EINVAL festgelegt

nicht geändert

Es sei denn, die Werten explizit während der Laufzeit geändert werden, sind die Standardwerte PST "" und "PDT" bzw. Die Größe dieser Zeichenarrays wird vom TZNAME_MAX-Wert bestimmt.

Anforderungen

Routine

Erforderlicher Header

_get_tzname

<time.h>

Weitere Informationen finden Sie unter Kompatibilität.

.NET Framework-Entsprechung

Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.

Siehe auch

Referenz

Uhrzeitverwaltung

errno, _doserrno, _sys_errlist und _sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX