_get_tzname

Artikel
06/09/2015

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.