Partager via


_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 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.

Configuration requise

Routine

En-tête requis

_get_tzname

<time.h>

Pour plus d'informations, consultez Compatibilité.

Équivalent .NET Framework

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

Voir aussi

Référence

Gestion du temps

errno, _doserrno, _sys_errlist et _sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX