Se recomienda usar Visual Studio 2017

_get_tzname

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Recupera la representación de cadena de caracteres del nombre de zona horaria o el nombre de zona de hora estándar de horario de verano (DST).

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

Parámetros

[out] pReturnValue
La longitud de cadena timeZoneName incluido un terminador NULL.

[out] timeZoneName
La dirección de una cadena de caracteres para la representación del nombre de zona horaria o el nombre de zona de hora estándar de horario de verano (DST), dependiendo de index.

[in] sizeInBytes
El tamaño de la timeZoneName en bytes de la cadena de caracteres.

[in] index
El índice de uno de los nombres de zona de horaria de dos a recuperar.

Cero si es correcto, de lo contrario, un errno el tipo de valor.

Si el valor timeZoneName es NULL, o sizeInBytes es cero o menor que cero (pero no ambos), se invoca un controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, la función establece errno en EINVAL y devuelve EINVAL.

Condiciones de error

pReturnValuetimeZoneNamesizeInBytesindexValor devueltoContenido de timeZoneName
tamaño de nombre de TZNULL00 o 10no modificado
tamaño de nombre de TZany> 00 o 10Nombre TZ
no modificadoNULL> 0cualquieraEINVALno modificado
no modificadoanycerocualquieraEINVALno modificado
no modificadoany> 0> 1EINVALno modificado

El _get_tzname función recupera la representación de cadena de caracteres del nombre de zona horaria o el nombre de zona de hora estándar de horario de verano (DST) en la dirección del timeZoneName según el valor de índice, junto con el tamaño de la cadena en pReturnValue. Si timeZoneName es NULL y sizeInBytes es cero, el tamaño de la cadena de hora zona en bytes se devuelve en pReturnValue. Los valores de índice deben ser 0 para la zona horaria estándar o 1 para la zona horaria estándar de horario de verano; todos los valores de índice tener resultados indeterminados.

Valores de índice

indexContenido de timeZoneNametimeZoneNamevalor predeterminado
0Nombre de zona horaria"PST"
1Nombre de la zona de horario de verano hora estándar"PDT"
> 1 o< 0></ 0>errnoestablecido enEINVALno modificado

A menos que explícitamente se cambian los valores en tiempo de ejecución, los valores predeterminados son "PST" y "PDT", respectivamente. Los tamaños de estas matrices de caracteres que se rigen por TZNAME_MAX valor.

RutinaEncabezado necesario
_get_tzname<time.h>

Para obtener más información, vea Compatibilidad.

No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Administración del tiempo
errno, _doserrno, _sys_errlist y _sys_nerr
_get_daylight
_get_dstbias
_get_timezone
TZNAME_MAX

Mostrar: