Partager via


_tzset

Variables d'environnement de temps de jeux.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

void _tzset( void );

Notes

La fonction d' _tzset utilise la configuration actuelle de la variable d'environnement TZ pour assigner des valeurs à trois variables globales : _daylight, _timezone, et _tzname.Ces variables sont utilisées par _ftime et localtime fonctionne pour apporter des corrections de temps universel coordonné (UTC) en heure locale, et par la fonction d' time de calculer l'heure UTC d'heure système.Utilisez la syntaxe suivante pour définir la variable d'environnement d' TZ :

setTZ=tzn[+ | –]hh[:mm[:ss] ][dzn]

  • tzn
    Nom du fuseau horaire de trois lettres, tel que PST.Vous devez spécifier l'offset correct de l'heure locale en heure UTC.

  • hh
    Différence en heures entre l'heure UTC et l'heure locale.Signez (+) facultatif pour les valeurs positives.

  • mm
    Minutes.Séparé d' hh par un signe deux-points (:).

  • ss
    Secondes.Séparé d' mm par un signe deux-points (:).

  • dzn
    Zone heure d'été de trois lettres telle que PDT.Si l'heure d'été n'est jamais en vigueur dans la localité, affectez TZ sans valeur pour dzn.La bibliothèque Runtime C suppose que les règles des états-unis pour implémenter le calcul de l'heure d'été (DST).

[!REMARQUE]

Prenez le soin de calcul le signe de la différence de temps.Étant donné que la différence de temps est l'offset de l'heure locale en heure UTC (plutôt que l'inverse), le signe peut être l'inverse de ce que vous pourriez intuitivement compter.Pour les fuseaux horaires avant avant UTC, la différence de temps est négative ; pour ceux qui sous-tendent l'heure UTC, la différence est positive.

Par exemple, pour définir la variable d'environnement d' TZ pour correspondre au fuseau horaire actuellement en Allemagne, tapez ce qui suit sur la ligne de commande :

set TZ=GST-1GDT

Cette commande utilise GST pour indiquer l'heure d'hiver allemande, suppose que l'heure UTC est d'une heure derrière l'Allemagne (ou en d'autres termes, cette Allemagne est d'une heure UTC avant avant), et suppose que l'Allemagne observe l'heure d'été.

Si la valeur d' TZ n'est pas définie, les tentatives d'tzset _d'utiliser les informations de fuseau horaire spécifié par le système d'exploitation.Dans le système d'exploitation Windows, ces informations sont spécifiées dans l'application de date/heure dans le panneau de configuration.Si _tzset ne peut pas obtenir ces informations, elles utilisent PST8PDT par défaut, c'est-à-dire le fuseau horaire du Pacifique.

En fonction de la valeur de la variable d'environnement d' TZ, les valeurs suivantes sont assignées aux variables globales _daylight, _timezone, et _tzname lorsque _tzset est appelé :

Variable globale

Description

Valeur par défaut

_daylight

Valeur différente de zéro si une zone heure d'été spécifiée dans la définition d' TZ ; sinon, 0.

1

_timezone

Différence en secondes entre l'heure locale et l'heure UTC.

28800 (28800 seconde equals de 8 heures)

_tzname[0]

Valeur de chaîne du nom du fuseau horaire de la variable d'environnement d' TZ ; vide si TZ n'a pas été défini.

PST

_tzname[1]

Valeur de chaîne de la zone heure d'été ; vide si la zone heure d'été est omise de la variable d'environnement d' TZ .

PDT

Les valeurs par défaut indiquées dans le tableau précédent pour _daylight et le tableau d' _tzname correspondent à « 8h PDT de PST ». Si la zone de Desktop prise en charge Technician est omise de la variable d'environnement d' TZ, la valeur d' _daylight est 0 et _ftime, gmtime, et retournent 0 de fonctions d' localtime pour leurs balises de Desktop prise en charge Technician.

Configuration requise

Routine

En-tête requis

_tzset

<time.h>

Pour plus d'informations, consultez l' Compatibilité.

Exemple

// crt_tzset.cpp
// This program uses _tzset to set the global variables
// named _daylight, _timezone, and _tzname. Since TZ is
// not being explicitly set, it uses the system time.

#include <time.h>
#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    _tzset();
    int daylight;
    _get_daylight( &daylight );
    printf( "_daylight = %d\n", daylight );
    long timezone;
    _get_timezone( &timezone );
    printf( "_timezone = %ld\n", timezone );
    size_t s;
    char tzname[100];
    _get_tzname( &s, tzname, sizeof(tzname), 0 );
    printf( "_tzname[0] = %s\n", tzname );
    exit( 0 );
}
  

É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

asctime, _wasctime

_ftime, _ftime32, _ftime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

time, _time32, _time64

_utime, _utime32 _utime64, _wutime, _wutime32, _wutime64