_tzset

  • [アーティクル]

時間環境変数を設定します。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

void _tzset( void );

解説

_tzset 関数は環境変数 TZ の現在の設定を使用して、 _daylight、 _timezone、および _tznameの 3 つのグローバル変数に値を代入します。 これらの変数は、協定世界時 (UTC) から現地時刻への修正、およびシステム時刻から UTC を計算する関数によって、およびlocaltime関数によってtime使用_ftimeされます。 TZ 環境変数を設定するには、次の構文を使用します。

set TZ=tzn [+|-]hh[:mm[:ss] ][dzn]

tzn
PST など、3 文字のタイム ゾーンの名前。 現地時刻から UTC への適切なオフセットを指定する必要があります。

hh
UTC と現地時刻の時差。 正の値のための符号 (+) オプション。

mm
分。 コロン ( hh ) で:との間を区切ります。

ss
秒。 コロン ( mm ) で:との間を区切ります。

dzn
PDT など、3 文字の夏時間のタイム ゾーン。 その地域で夏時間が実施されていない場合は、 TZ の値を指定しないで dznを設定します。 C ランタイム ライブラリでは、アメリカ合衆国の規則を前提に夏時間 (DST) を計算します。

Note

計算時には時差の符号に注意してください。 時差は現地時刻から UTC に変換する場合のオフセットである (逆ではない) であるため、符号は直感的に考えるものとは逆である場合があります。 UTC より早いタイム ゾーンの場合、時差は負になります。UTC より遅い場合、時差は正になります。

たとえば、ドイツの現在の TZ タイム ゾーンに対応するように環境変数を設定するには、コマンド ラインで次のコマンドを入力します。

set TZ=GST-1GDT

このコマンドは、GST を使用してドイツ標準時を示します。 これは、UTC がドイツより 1 時間遅れている (つまり、ドイツが UTC より 1 時間早い) ことを前提としています。 そして、ドイツは夏時間を観察することを前提としています。

値が TZ 設定されていない場合は、 _tzset オペレーティング システムで指定されたタイム ゾーン情報の使用を試みます。 Windows オペレーティング システムの場合、この情報は [コントロール パネル] の [日付/時刻] で指定します。 この情報を取得できない場合 _tzset は、既定でPST8PDTが使用されます。これは太平洋タイム ゾーンを示します。

TZ が呼び出されると、 _daylightの環境変数の値に基づいて、次の値がグローバル変数 _timezone、 _tzname 、および _tzset に代入されます。

グローバル変数 説明 既定値
_daylight 夏時間のタイム ゾーンが TZ の設定で指定されている場合は 0 以外の値、指定されていない場合は 0。 1
_timezone 現地時刻と UTC の秒単位での時差。 28800 (28,800 秒は 8 時間)
_tzname[0] 環境変数からの TZ タイム ゾーン名の文字列値。設定されていない場合 TZ は空。 PST
_tzname[1] 夏時間のタイム ゾーンの文字列値。 TZ の環境変数の値に夏時間のタイム ゾーンが含まれていない場合は空。 PDT

前の表_daylightに示した既定値と_tzname配列は、"PST8PDT" に対応します。DST ゾーンが環境変数からTZ省略されている場合、値_daylightは 0 で_ftimegmtimelocaltime、関数は DST フラグに対して 0 を返します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値 必須ヘッダー
_tzset <time.h>

この _tzset 関数は Microsoft 固有です。 詳細については、「互換性」をご覧ください。

例

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

_daylight = 1
_timezone = 28800
_tzname[0] = Pacific Standard Time

関連項目

時間管理
asctime, _wasctime
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64