_get_tzname

Artykuł
06/09/2015

Pobiera reprezentację ciąg znaków nazwy strefy czasowej lub nazwa strefy (czas standardowy) czasu letniego (DST).

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

Parametry

[poza] pReturnValue
Długość ciągu timeZoneName w tym końcowych wartości NULL.
[poza] timeZoneName
Adres ciąg znaków do przedstawienia nazwy strefy czasowej lub nazwa strefy (czas standardowy) czasu letniego (DST), w zależności od index.
[in] sizeInBytes
Rozmiar timeZoneName znaków ciągu w bajtach.
[in] index
Indeks jedną z nazw dwie strefy czasowej do pobrania.

Wartość zwracana

Zero, jeśli kończy się pomyślnie, w przeciwnym razie errno należy wpisać wartość.

Jeśli każda timeZoneName jest NULL, lub sizeInBytes wynosi zero lub mniej niż zero (ale nie obu), wywołać program obsługi nieprawidłowy parametr zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcja ta ustawia errno jako EINVAL i zwraca EINVAL.

Warunki błędów

pReturnValue	timeZoneName	sizeInBytes	index	Wartość zwrócona	ZawartośćtimeZoneName
Rozmiar Nazwa TZ	NULL	0	0 lub 1	0	nie zmodyfikowano
Rozmiar Nazwa TZ	jakakolwiek	> 0	0 lub 1	0	Nazwa TZ
nie zmodyfikowano	NULL	> 0	jakakolwiek	EINVAL	nie zmodyfikowano
nie zmodyfikowano	jakakolwiek	zero	jakakolwiek	EINVAL	nie zmodyfikowano
nie zmodyfikowano	jakakolwiek	> 0	> 1	EINVAL	nie zmodyfikowano

Uwagi

_get_tzname Funkcja pobiera reprezentację ciąg znaków nazwy strefy czasowej lub nazwa strefy (czas standardowy) czasu letniego (DST) pod adresem timeZoneName w zależności od wartości indeksu, wraz z wielkością ciąg w pReturnValue.Jeśli timeZoneName jest NULL i sizeInBytes jest zero, tylko rozmiar ciągu albo czas strefy w bajtach jest zwracany w pReturnValue.Wartości indeksu musi być 0 dla strefy (czas standardowy) lub 1 dla strefy czasowej standardowe światło dzienne; mieć wartości indeksu nieokreślony wyników.

Wartości indeksu

index	ZawartośćtimeZoneName	timeZoneNameWartość domyślna
0	Nazwa strefy czasowej	"PST"
1	Nazwa strefy czasu letniego (czas standardowy)	"PDT"
>1 lub < 0	errnozestaw doEINVAL	nie zmodyfikowano

Jeśli wartości są zmieniane jawnie w czasie wykonywania, wartości domyślne są "PST" i "PDT" odpowiednio. Rozmiary te tablice znaków są regulowane przez TZNAME_MAX wartości.