_get_tzname

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Récupère la représentation de chaîne de caractères du nom fuseau horaire ou le nom de zone de temps standard de l’heure d’été (DST).

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

Paramètres

[out] pReturnValue
La longueur de chaîne timeZoneName , y compris une marque de fin NULL.

[out] timeZoneName
L’adresse d’une chaîne de caractères pour la représentation du nom fuseau horaire ou le nom de zone de temps standard de l’heure d’été (DST), selon la index.

[in] sizeInBytes
La taille de la timeZoneName chaîne en octets de caractères.

[in] index
Index d’un des noms de deux fuseaux horaires à récupérer.

Zéro en cas de réussite, sinon un errno type valeur.

Si le paramètre timeZoneName est NULL, ou sizeInBytes est égal à zéro ou inférieure à zéro (mais pas les deux), un gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction affecte la valeur errno à EINVAL et retourne EINVAL.

Conditions d’erreur

pReturnValuetimeZoneNamesizeInBytesindexValeur de retourContenu de timeZoneName
taille de nom TZNULL00 ou 10non modifié
taille de nom TZany> 00 ou 10Nom TZ
non modifiéNULL> 0anyEINVALnon modifié
non modifiéanyzéroanyEINVALnon modifié
non modifiéany> 0> 1EINVALnon modifié

Le _get_tzname fonction récupère la représentation de chaîne de caractères du nom fuseau horaire ou le nom de zone de temps standard de l’heure d’été (DST) dans l’adresse de timeZoneName selon la valeur d’index, ainsi que la taille de la chaîne dans pReturnValue. Si timeZoneName est NULL et sizeInBytes est égal à zéro, uniquement la taille de la chaîne d’heure zone en octets est renvoyé dans pReturnValue. Les valeurs d’index doivent être 0 pour le fuseau horaire ou 1 pour le fuseau horaire de l’heure d’été ; toutes les autres valeurs d’index ont des résultats indéterminées.

Valeurs d’index

indexContenu de timeZoneNametimeZoneNamevaleur par défaut
0Nom du fuseau horaire« PST »
1Nom de la zone heure d’hiver« PDT »
> 1 ou< 0></ 0>errnola valeurEINVALnon modifié

À moins que les valeurs sont explicitement modifiés pendant l’exécution, les valeurs par défaut sont respectivement « PST » et « PDT ». Les tailles de ces tableaux de caractères sont régies par TZNAME_MAX valeur.

RoutineEn-tête requis
_get_tzname<time.h>

Pour plus d'informations, voir Compatibilité.

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Gestion du temps
errno, _doserrno, _sys_errlist et _sys_nerr
_get_daylight
_get_dstbias
_get_timezone
TZNAME_MAX

Afficher: