Partager via


_get_tzname

Extrait la représentation de chaîne de caractères du nom du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician).

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

Paramètres

  • [out] pReturnValue
    La longueur de chaîne d' 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 du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician), selon index.

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

  • [in] index
    L'index de l'un des deux noms de fuseau horaire à récupérer.

Valeur de retour

Zéro si l'opération a réussi, sinon une valeur de type d' errno .

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

conditions d'erreur

pReturnValue

timeZoneName

sizeInBytes

index

Valeur de retour

contenu d' timeZoneName

taille du nom de la t-z

NULL

0

0 ou 1 ;

0

non modifié

taille du nom de la t-z

quels

> 0

0 ou 1 ;

0

La t-z nom

non modifié

NULL

> 0

quels

EINVAL

non modifié

non modifié

quels

zéro

quels

EINVAL

non modifié

non modifié

quels

> 0

> 1

EINVAL

non modifié

Notes

La fonction d' _get_tzname récupère la représentation de chaîne de caractères du nom du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician) dans l'adresse d' timeZoneName selon la valeur d'index, ainsi que la taille de la chaîne dans pReturnValue.Si timeZoneName est NULL et sizeInBytes est zéro, juste la taille de la chaîne de fuseau horaire en octets est retournée dans pReturnValue.Les valeurs d'index doivent être 0 pour le fuseau horaire standard ou 1 pour le fuseau horaire standard de lumière du jour ; toutes les autres valeurs d'index ont des résultats indéterminés.

valeurs d'index

index

contenu d' timeZoneName

valeur par défaut d'timeZoneName

0

nom du fuseau horaire

« PST »

1

Nom du fuseau horaire standard de lumière du jour

« PDT »

> 1 ou < 0

errno défini à EINVAL

non modifié

À moins que les valeurs sont 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 d' TZNAME_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 l' exemples d'appel de code non managé.

Voir aussi

Référence

Gestion de la durée

errno, _doserrno, _sys_errlist, et _sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX