_tzset

Articolo
03/26/2013

Variabili di ambiente di tempo su.

Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

void _tzset( void );

Note

La funzione di _tzset utilizza l'impostazione corrente della variabile di ambiente TZ per assegnare valori a tre variabili globali: _daylight, _timezonee _tzname.Queste variabili vengono utilizzate le funzioni di localtime e di _ftime per apportare modifiche a partire da formato UTC (UTC) nell'ora locale e alla funzione di time calcolare l'ora UTC dall'ora di sistema.Utilizzare la sintassi seguente per impostare la variabile di ambiente TZ :

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

tzn
Nome di tre lettere del fuso orario, come PST.È necessario specificare l'offset corretto dall'ora locale in ora UTC.
hh
In ore differenza tra l'ora UTC e l'ora locale.Firmare (+) facoltativo per i valori positivi.
mm
Rapporto.Separato da hh da due punti (:).
ss
Secondi.Separato da mm da due punti (:).
dzn
Area dell'ora legale di tre lettere come PDT.Se l'ora legale non è mai in effetti la località, impostare TZ senza un valore per dzn.La libreria di runtime C presuppone le regole degli Stati Uniti per implementare il calcolo dell'ora legale (DST).

[!NOTA]

Creare la visualizzazione in calcolare il segno della differenza di tempo.Poiché la differenza di ora è l'offset dall'ora locale in ora UTC anziché di l inverso), il simbolo può essere l'opposto di cui è possibile prevedere intuitivo.Per i fusi orari rispetto a UTC, la differenza di è negativa, per quelli all'ora UTC, la differenza è positivo.

Ad esempio, per impostare la variabile di ambiente TZ in base al fuso orario corrente in Germania, immettere quanto segue nella riga di comando:

set TZ=GST-1GDT

Questo comando utilizza GST per leggere l'ora solare tedesca, si presuppone che l'ora UTC è un'ora in Germania (o ovvero quella la Germania è un'ora rispetto a UTC) e presuppone che la Germania esaminate l'ora legale.

Se il valore di TZ non è impostato, _tzset tenta di utilizzare le informazioni del fuso orario specificato dal sistema operativo.Nel sistema operativo Windows, queste informazioni vengono specificate nell'applicazione data/ora nel Pannello di controllo.Se _tzset non può ottenere queste informazioni, utilizzare PST8PDT per impostazione predefinita, ovvero il fuso orario Ora solare Pacifico.

In base al valore della variabile di ambiente TZ, i valori seguenti vengono assegnati a variabili globali _daylight, _timezonee _tzname quando _tzset è denominato:

Variabile globale	Descrizione	Valore predefinito
_daylight	Valore diverso da zero se un'area di ora legale viene specificata nell'impostazione di TZ ; in caso contrario, 0.	1
_timezone	Differenza in secondi tra l'ora locale e l'ora UTC.	28800 (28800 valore è uguale a 8 ore)
_tzname[0]	Valore di stringa del nome del fuso orario dalla variabile di ambiente TZ ; vuota se TZ non è stato impostato.	PST
_tzname[1]	Valore di stringa dell'area dell'ora legale, vuota se l'area dell'ora legale viene omessa la variabile di ambiente TZ.	PDT

I valori predefiniti indicati nella tabella precedente per _daylight e la matrice di _tzname corrispondono a "PST8PDT". Se l'area di DST viene omessa la variabile di ambiente TZ, il valore di _daylight è 0 e _ftime, gmtimee restituiscono 0 di funzioni di localtime per i flag di DST.

Requisiti

Routine	Intestazione obbligatoria
_tzset	<time.h>

Per ulteriori informazioni, vedere Compatibilità.

Esempio

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