_tzset

Article
03/26/2013

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 );
}