_get_tzname

Artigo
06/09/2015

Recupera a representação de cadeia de caracteres de nome de fuso horário ou o nome do deslocamento de fuso horário padrão para baixo clara do dia (DST).

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

Parâmetros

[saída] pReturnValue
O comprimento da cadeia de caracteres de timeZoneName que inclui um terminador NULL.
[saída] timeZoneName
O endereço de uma cadeia de caracteres para que representa o nome de fuso horário ou o nome do deslocamento de fuso horário padrão para baixo clara do dia (DST), dependendo de index.
[entrada] sizeInBytes
O tamanho da cadeia de caracteres de timeZoneName em bytes.
[entrada] index
O índice de um dos dois nomes de fuso horário a ser recuperado.

Valor de retorno

Zero se bem-sucedido, caso contrário um valor do tipo de errno .

Se ou timeZoneName é NULL, ou sizeInBytes for nula ou menor que zero (mas não ambos), um manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução puder continuar, essa função definirá errno como EINVAL e retornará EINVAL.

Condições de erro

pReturnValue	timeZoneName	sizeInBytes	index	Valor de retorno	Conteúdo de timeZoneName
tamanho do nome de TZ	NULL	0	0 ou 1	0	não modificado
tamanho do nome de TZ	any	> 0	0 ou 1	0	A nomeação 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

A função de _get_tzname recupera a representação de cadeia de caracteres de nome de fuso horário ou o nome do deslocamento de fuso horário padrão para baixo clara do dia (DST) no endereço de timeZoneName dependendo do valor de índice, junto com o tamanho da cadeia de caracteres em pReturnValue. Se timeZoneName é NULL e sizeInBytes for zero, apenas o tamanho da cadeia de caracteres de um ou outro fuso horário em bytes será retornado em pReturnValue. Os valores de índice deve ser 0 para o fuso horário padrão ou 1 para o fuso horário padrão para baixo clara do dia; todos os outros valores de índice terão resultados indefinidos.

Valores de índice

index	Conteúdo de timeZoneName	valor padrão detimeZoneName
0	Nome de fuso horário	“PST”
1	Nome do deslocamento de fuso horário padrão para baixo clara do dia	“PDT”
> 1 ou < 0	errno definido como EINVAL	não modificado

A menos que os valores sejam alterados explicitamente durante o tempo de execução, os valores padrão são “PST” e “PDT” respectivamente. Os tamanhos das matrizes de caractere são controlados pelo valor de TZNAME_MAX .