+++ /dev/null
-.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
-.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\" References consulted:
-.\" Linux libc source code
-.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
-.\" 386BSD man pages
-.\" Modified Sun Jul 25 11:01:58 1993 by Rik Faith (faith@cs.unc.edu)
-.\" Modified 2001-11-13, aeb
-.\" Modified 2004-12-01 mtk and Martin Schulze <joey@infodrom.org>
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
-.\" Translated 1998-03-23, NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" Updated 2000-09-14, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2002-01-06, NAKANO Takeo
-.\" Updated 2007-01-07, Akihiro MOTOKI, catch up to LDP v2.43
-.\"
-.TH TZSET 3 2015\-01\-30 "" "Linux Programmer's Manual"
-.SH 名前
-tzset, tzname, timezone, daylight \- 時刻の変換情報を初期化する
-.SH 書式
-.nf
-\fB#include <time.h>\fP
-.sp
-\fBvoid tzset (void);\fP
-.sp
-\fBextern char *\fP\fItzname\fP\fB[2];\fP
-\fBextern long \fP\fItimezone\fP\fB;\fP
-\fBextern int \fP\fIdaylight\fP\fB;\fP
-.fi
-.sp
-.in -4n
-glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
-.in
-.sp
-\fBtzset\fP(): _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
-.br
-\fItzname\fP: _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
-.br
-\fItimezone\fP: _SVID_SOURCE || _XOPEN_SOURCE
-.br
-\fIdaylight\fP: _SVID_SOURCE || _XOPEN_SOURCE
-.SH 説明
-\fBtzset\fP() 関数は \fBTZ\fP 環境変数を用いて \fItzname\fP 変数を初期化する。
-この関数は、タイムゾーンに依存する他の時刻変換関数から自動的に呼び出される。 System V 的な環境では、この関数は変数 \fItimezone\fP
-(UTC からの西向きの秒数) と \fIdaylight\fP (このタイムゾーンにサマータイムに関するルールがなければ 0、
-サマータイム期間が一年のどこかにあれば 0 以外) も設定する。
-.PP
-\fBTZ\fP 環境変数が設定されていない場合には、 システムのタイムゾーンが使用される。 ステムのタイムゾーンを設定するには、 \fBtzfile\fP(5)
-形式のファイルを \fI/etc/localtime\fP にコピーしたりリンクしたりする。
-これらのファイルがあるタイムゾーンデータベースはシステムのタイムゾーンディレクトリ (\fBファイル\fP の節を参照) に置かれている。
-.PP
-\fBTZ\fP 環境変数が存在しているが、その値が空だったり、 以下に示す形式のどれにもあてはまらない場合は、 協定世界時 (Coordinated
-Universal Time: UTC) が用いられる。
-.PP
-\fBTZ\fP の値は以下の 2 つの形式のいずれかを取ることができる。 最初の形式は、 使用するタイムゾーンを表す文字列を直接指定する方法である。
-.sp
-.RS
-std offset \fIdst\fP[\fIoffset\fP][,\fIstart\fP[\fI/time\fP],\fIend\fP[\fI/time\fP]]
-.RE
-.sp
-この指定方法ではスペースは一切使用しない。 \fIstd\fP 文字列はタイムゾーンの名前を指定する。 アルファベットからなる 3
-文字以上の文字列でなければならない。 \fIoffset\fP 文字列は \fIstd\fP の直後に続き、 協定世界時 (UTC) を得るために
-ローカルな時刻に加えなければならない時間を指定する。 \fIoffset\fP は、ローカルタイムゾーンがグリニッジ子午線 (Prime Meridian)
-の西なら正の値、東なら負の値を取る。 時間 (hour) は 0 から 24 の間でなければならない。 分 (minute) と秒 (second) は
-0 から 59 の間でなければならない。
-.PP
-\fIdst\fP 文字列と \fIoffset\fP は、 対応するサマータイムゾーンの名前とオフセットを指定する。
-オフセットが省略されると、デフォルトでは標準の一時間前となる。
-.PP
-\fIstart\fP フィールドはサマータイムが有効になる時刻、 \fIend\fP フィールドは標準に戻る時刻である。
-これらのフィールドは以下の形式で指定する。
-.TP
-J\fIn\fP
-年の通日 (Julian day) で日にちを指定する。
-\fIn\fP は 1 から 365 の間の数値。閏日は計算に入らない。
-この形式では、2 月 29 日を表現することはできず、
-2 月 28 日が第 59 日で、3 月 1 日が常に第 60 日となる。
-.TP
-\fIn\fP
-年の通日 (Julian day) で日にちを指定する。
-\fIn\fP は 1 から 365 の間の数値。
-閏年の場合も、2 月 29 日も日にちの計算に含められる。
-.TP
-M\fIm\fP.\fIw\fP.\fId\fP
-\fIm\fP は月 (1 <= \fIm\fP <= 12) を、 \fIw\fP は月のうちの週 (1 <= \fIw\fP <= 5)
-を、 \fId\fP は週のうちの日にち (0 <= \fId\fP <= 6) を示す。 \fIw\fP = 1 は所属する \fId\fP
-が存在する最初の週、 \fIw\fP = 5 は最後の週である。 \fId\fP = 0 は日曜日である。
-.PP
-\fItime\fP フィールドは、ローカルタイムを切り替える時刻を、 変更前のローカルタイムで表したものである。 省略された場合のデフォルトは
-02:00:00 である。
-
-ニュージーランドの例である。 ニュージーランドでは、標準のタイムゾーン (NZST) は UTC より 12時間進んでおり、 サマータイム (NZDT)
-は UTC の 13時間進んでいる。 サマータイムは 10月の第一日曜から 3月の第三日曜までであり、 ローカルタイムの切り替えはデフォルトの
-02:00:00 に行われる。
-.nf
-
- TZ="NZST\-12:00:00NZDT\-13:00:00,M10.1.0,M3.3.0"
-.fi
-.PP
-2 番目の形式は、タイムゾーンの情報をファイルから読み込むように指定する。
-.sp
-.RS
-:[filespec]
-.RE
-.sp
-ファイルの指定 \fIfilespec\fP が省略された場合、 もしくは指定された値が解釈できない場合、 協定標準時 (UTC; Coordinated
-Universal Time) が使用される。 指定された場合、 \fIfilespec\fP はタイムゾーン情報を読み出す \fBtzfile\fP(5)
-形式のファイルを指定する。 \fIfilespec\fP が \(aq/\(aq で始まっていない場合には、 システムタイムゾーンディレクトリからの相対パスで
-ファイルが指定されたことになる。 コロンが省略された場合には、 上記の \fBTZ\fP の各形式での解釈を試みる。
-.PP
-例を挙げておく。もう一度ニュージーランドの例である。
-.nf
-
- TZ=":Pacific/Auckland"
-.fi
-.SH 環境変数
-.TP
-\fBTZ\fP
-この変数が設定された場合、 その値がシステムで設定されたタイムゾーンより優先して使用される。
-.TP
-\fBTZDIR\fP
-この変数が設定された場合、 その値がシステムで設定されたタイムゾーンデータベースのディレクトリパスより優先して使用される。
-.SH ファイル
-.TP
-\fB/etc/localtime\fP
-システムのタイムゾーンファイル。
-.TP
-\fB/usr/share/zoneinfo/\fP
-システムのタイムゾーンデータベースのディレクトリ。
-.TP
-\fB/usr/share/zoneinfo/posixrules\fP
-TZ 文字列で dst タイムゾーンが他に何の指定なしで単独で指定された場合、 このファイルが start/end のルールに使用される。
-このファイルは \fBtzfile\fP(5) 形式である。 デフォルトでは、 ゾーン情報の Makefile でこのファイルは
-\fIAmerica/New_York\fP にハードリンクされる。
-.PP
-上記は現在の標準のファイルの場所だが、 glibc のコンパイル時に変更できる。
-.SH 準拠
-SVr4, POSIX.1\-2001, 4.3BSD.
-.SH 注意
-\fIdaylight\fP 変数は、現在がサマータイムであるかどうかを示しているのではない。 これはいくつかあるアルゴリズムのうちの番号を与える
-(アルゴリズムについては \fBgettimeofday\fP(2) の \fItz_dsttime\fP 変数を見よ)。
-これはもう何年も使われていないが、SUSv2 では必要とされている。
-.LP
-4.3BSD には \fBchar *timezone(\fP\fIzone\fP\fB, \fP\fIdst\fP\fB)\fP というルーチンがあり、これは 最初の引数 (UTC
-からの西向きの分数) に対応するタイムゾーンの名前を返す。 二番目の引数が 0 の場合は標準の名前が用いられ、
-それ以外はサマータイム版の名前が用いられる。
-.SH 関連項目
-\fBdate\fP(1), \fBgettimeofday\fP(2), \fBtime\fP(2), \fBctime\fP(3), \fBgetenv\fP(3),
-\fBtzfile\fP(5)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
