_get_tzname

Article
06/09/2015

Récupère la représentation de chaîne de caractères du nom du fuseau horaire ou le nom de fuseau horaire 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 detimeZoneName inclue un marqueur de fin NULL.
[out] timeZoneName
L'adresse d'une chaîne de caractères pour la représentation du fuseau horaire oudu duseau horaire standard heure d'été (DST), dépend de index.
[in] sizeInBytes
La taille du caractère timeZoneName en octets.
[in] index
L'index de l'un des deux noms de fuseau horaire à récupérer.

Valeur de retour

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

Si soit timeZoneName est NULL, soit sizeInBytes est nul ou négatif (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 paramètre errno à EINVAL et renvoie EINVAL.

Conditions d'erreur

pReturnValue	timeZoneName	sizeInBytes	index	Valeur de retour	Contenu de timeZoneName.
taille du nom TZ	NULL	0	0 ou 1 ;	0	non modifié
taille du nom TZ	any	> 0	0 ou 1 ;	0	nom TZ
non modifié	NULL	> 0	any	EINVAL	non modifié
non modifié	any	zéro	any	EINVAL	non modifié
non modifié	any	> 0	> 1	EINVAL	non modifié

Notes

La fonction _get_tzname récupère la représentation de chaîne de caractères du nom du fuseau horaire ou le nom de fuseau horaire standard d'heure d'été (DST) dans l'adresse detimeZoneName selon la valeur d'index, ainsi que la taille de la chaîne dans pReturnValue. Si timeZoneName est NULL et quesizeInBytes est de zéro, la taille de la chaine de l'un des deux fuseaux horaires est retourné dans pReturnValue. Les valeurs d'index doivent être 0 pour le fuseau horaire standard ou 1 pour le fuseau horaire standard d'heure d'été ; toutes les autres valeurs d'index ont des résultats indéterminés.

Valeurs d'index

index	Contenu de timeZoneName.	Valeur par défaut timeZoneName.
0	Nom du fuseau horaire	"PST"
1	Obtient le nom du fuseau horaire standard heure d'été.	"PDT"
> 1 ou < 0	Affectez à errno la valeur EINVAL.	non modifié

À moins que les valeurs ne soient explicitement modifiées au moment de l'exécution, les valeurs par défaut sont « PST » et « PDT » respectivement. Les tailles de ces tableaux de caractères sont régies par valeur deTZNAME_MAX.