_get_tzname

Статья
06/09/2015

Получает представление в виде символьной строки имени часового пояса или имени зоны стандартного летнего времени (DST).

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

Параметры

[исходящий] pReturnValue
Длина строки timeZoneName, включая конечный нуль-символ.
[исходящий] timeZoneName
Адрес символьной строки для представления имени часового пояса или имени зоны стандартного летнего времени (DST), в зависимости от index.
[входящий] sizeInBytes
Размер символьной строки timeZoneName в байтах.
[входящий] index
Индекс одного из двух имен часового пояса, который необходимо извлечь.

Возвращаемое значение

Ноль в случае успеха, в противном случае значение типа errno.

Если либо timeZoneName равно NULL, либо sizeInBytes равно нулю или меньше нуля (но не и то, и то), вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, функция устанавливает errno в EINVAL и возвращает EINVAL.

Условия возникновения ошибки

pReturnValue	timeZoneName	sizeInBytes	index	Возвращаемое значение	Содержимое timeZoneName.
размер имени TZ	NULL	0	0 или 1	0	без изменений
размер имени TZ	any	> 0	0 или 1	0	имя TZ
без изменений	NULL	> 0	any	EINVAL	без изменений
без изменений	any	нуль	any	EINVAL	без изменений
без изменений	any	> 0	> 1	EINVAL	без изменений

Заметки

Функция _get_tzname извлекает представление в виде символьной строки имени часового пояса или имени зоны стандартного летнего времени (DST) в адрес timeZoneName, в зависимости от значения индекса, а также размера строки в pReturnValue. Если timeZoneName равно NULL, и sizeInBytes равно нулю, размер строки в байтах любого часового пояса возвращается в pReturnValue. Значения индекса должны быть либо 0 для зоны стандартного времени, либо 1 для зоны стандартного летнего времени; все остальные значения индекса приводят к неопределённым результатам.

Значения индекса

index	Содержимое timeZoneName.	Значение timeZoneName по умолчанию
0	Имя часового пояса	"PST"
1	Имя зоны стандартного летнего времени	"PDT"
> 1 или < 0	errno принимает значение EINVAL.	без изменений

Если значения явно не изменяются во время выполнения, значения по умолчанию равны «PST» и «PDT» соответственно. Размеры этих массивов символов управляются значением TZNAME_MAX.