_get_tzname

Artigo
02/25/2013

Recupera a representação da cadeia de caracteres do nome do fuso horário ou o nome de zona de hora padrão do horário de verão (DST).

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

Parâmetros

[out]pReturnValue
O comprimento da seqüência timeZoneName incluindo um terminador nulo.
[out]timeZoneName
O endereço de uma seqüência de caracteres para a representação do nome do fuso horário ou o nome de zona de hora padrão do horário de verão (DST), dependendo do index.
[in]sizeInBytes
O tamanho da timeZoneName série de caracteres em bytes.
[in]index
O índice de um dos nomes de dois fuso de horário para recuperar.

Valor de retorno

Zero se for bem sucedido, caso contrário, um errno digite valor.

Se qualquer um dos timeZoneName é NULL, ou sizeInBytes é zero ou menor que zero (mas não ambos), um manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essa função define errno para EINVAL e retorna EINVAL.

Condições de erro

pReturnValue	timeZoneName	sizeInBytes	index	Valor de Retorno	Conteúdo detimeZoneName
tamanho do nome TZ	NULL	0	0 ou 1	0	não modificado
tamanho do nome TZ	any	> 0	0 ou 1	0	Nome TZ
não modificado	NULL	> 0	any	EINVAL	não modificado
não modificado	any	zero	any	EINVAL	não modificado
não modificado	any	> 0	> 1	EINVAL	não modificado

Comentários

O _get_tzname função recupera a representação da cadeia de caracteres do nome do fuso horário ou o nome de zona de hora padrão do horário de verão (DST) para o endereço do timeZoneName dependendo do valor de índice, juntamente com o tamanho da seqüência de caracteres em pReturnValue.Se timeZoneName é NULL e sizeInBytes é igual a zero, o tamanho da seqüência de caracteres de qualquer tempo de zona em bytes é retornada em pReturnValue.Os valores de índice devem ser 0 para o fuso horário padrão ou 1 para o fuso horário padrão de verão; quaisquer outros valores de índice têm resultados indeterminados.

Valores de índice

index	Conteúdo detimeZoneName	timeZoneNamevalor padrão
0	Nome do fuso horário	"PST"
1	Nome de zona de hora padrão do horário de verão	"PDT"
> 1 ou < 0	errnodefinido comoEINVAL	não modificado

A menos que explicitamente, os valores são alterados durante o tempo de execução, os valores padrão são "PST" e "PDT" respectivamente.Os tamanhos desses conjuntos de caracteres são regidos por TZNAME_MAX valor.