OSDN Git Service

Update drafts for v3.79
[linuxjm/LDP_man-pages.git] / draft / man3 / tzset.3
index af683fd..fda42f6 100644 (file)
@@ -42,7 +42,7 @@
 .\" Updated 2002-01-06, NAKANO Takeo
 .\" Updated 2007-01-07, Akihiro MOTOKI, catch up to LDP v2.43
 .\"
-.TH TZSET 3 2014\-08\-19 "" "Linux Programmer's Manual"
+.TH TZSET 3 2015\-01\-30 "" "Linux Programmer's Manual"
 .SH 名前
 tzset, tzname, timezone, daylight \- 時刻の変換情報を初期化する
 .SH 書式
@@ -73,35 +73,33 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参
 (UTC からの西向きの秒数) と \fIdaylight\fP (このタイムゾーンにサマータイムに関するルールがなければ 0、
 サマータイム期間が一年のどこかにあれば 0 以外) も設定する。
 .PP
-\fBTZ\fP 環境変数が設定されていない場合には、 \fItzname\fP 変数はローカルな壁時計時刻 (wall clock time) に
-最も近い値に初期化される。 このローカルな壁時計時刻としては、 システムのタイムゾーンディレクトリ (後述) にある \fBtzfile\fP(5)
-形式のファイル \fIlocaltime\fP で指定されている値が用いられる。 (この際には \fI/etc/localtime\fP もよく用いられる。
-これはシステムのタイムゾーンディレクトリにある 適切なファイルへのシンボリックリンクになっている。)
+If the \fBTZ\fP variable does not appear in the environment, the system
+timezone is used.  The system timezone is configured by copying, or linking,
+a file in the \fBtzfile\fP(5) format to \fI/etc/localtime\fP.  A timezone database
+of these files may be located in the system timezone directory (see the
+\fBFILES\fP section below).
 .PP
 \fBTZ\fP 環境変数が存在しているが、その値が空だったり、 以下に示す形式のどれにもあてはまらない場合は、 協定世界時 (Coordinated
 Universal Time: UTC) が用いられる。
 .PP
-\fBTZ\fP の値は以下の 3 つの形式のいずれかを取ることができる。 最初の形式はサマータイム (daylight saving time)
-を持たないローカルタイムゾーンに対して用いる。
+The value of \fBTZ\fP can be one of two formats.  The first format is a string
+of characters that directly represent the timezone to be used:
 .sp
 .RS
-\fIstd offset\fP
+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 の間でなければならない。
+There are no spaces in the specification.  The \fIstd\fP string specifies the
+name of the timezone and must be three or more alphabetic characters.  The
+\fIoffset\fP string immediately follows \fIstd\fP and specifies the time value to
+be added to the local time to get Coordinated Universal Time (UTC).  The
+\fIoffset\fP is positive if the local timezone is west of the Prime Meridian
+and negative if it is east.  The hour must be between 0 and 24, and the
+minutes and seconds 0 and 59.
 .PP
-2 番目の形式はサマータイムがある場合に用いられる。
-.sp
-.RS
-\fIstd offset dst [offset],start[/time],end[/time]\fP
-.RE
-.sp
-指定にはスペースを含めてはならない。 先頭の \fIstd\fP と \fIoffset\fP は 1 番目の形式と同じで、 標準のタイムゾーンを指定する。
-\fIdst\fP 文字列と \fIoffset\fP は、 対応するサマータイムゾーンの名前とオフセットを指定する。
-オフセットが省略されると、デフォルトでは標準の一時間前となる。
+The \fIdst\fP string and \fIoffset\fP specify the name and offset for the
+corresponding daylight saving timezone.  If the offset is omitted, it
+defaults to one hour ahead of standard time.
 .PP
 \fIstart\fP フィールドはサマータイムが有効になる時刻、 \fIend\fP フィールドは標準に戻る時刻である。
 これらのフィールドは以下の形式で指定する。
@@ -133,36 +131,50 @@ M\fIm\fP.\fIw\fP.\fId\fP
     TZ="NZST\-12:00:00NZDT\-13:00:00,M10.1.0,M3.3.0"
 .fi
 .PP
-3 番目の形式は、タイムゾーンの情報をファイルから読み込むように指定する。
+The second format specifies that the timezone information should be read
+from a file:
 .sp
 .RS
 :[filespec]
 .RE
 .sp
-ファイルの指定 \fIfilespec\fP が省略された場合は、 タイムゾーンの情報はシステムタイムゾーンディレクトリの \fIlocaltime\fP
-ファイルから読まれる。 最近ではシステムタイムゾーンディレクトリは普通 \fI/usr/share/zoneinfo/localtime\fP である。
-このファイルは \fBtzfile\fP(5)  形式で書かれている。 \fIfilespec\fP が与えられた場合は、
-タイムゾーンの情報をそのファイルから読み込む。このファイルも \fBtzfile\fP(5)  形式で書かれている必要がある。 \fIfilespec\fP が
-\(aq/\(aq で始まらなかった場合には、 システムタイムゾーンディレクトリからの相対パスで ファイルが指定されたことになる。
+If the file specification \fIfilespec\fP is omitted, or its value cannot be
+interpreted, then Coordinated Universal Time (UTC) is used.  If \fIfilespec\fP
+is given, it specifies another \fBtzfile\fP(5)\-format file to read the timezone
+information from.  If \fIfilespec\fP does not begin with a \(aq/\(aq, the file
+specification is relative to the system timezone directory.  If the colon is
+omitted each of the above \fBTZ\fP formats will be tried.
 .PP
 例を挙げておく。もう一度ニュージーランドの例である。
 .nf
 
     TZ=":Pacific/Auckland"
 .fi
+.SH 環境変数
+.TP 
+\fBTZ\fP
+If this variable is set its value takes precedence over the system
+configured timezone.
+.TP 
+\fBTZDIR\fP
+If this variable is set its value takes precedence over the system
+configured timezone database directory path.
 .SH ファイル
-glibc では、システムのタイムゾーンディレクトリは \fBTZDIR\fP 環境変数を使って決定される。 \fBTZDIR\fP
-がセットされていない場合、デフォルト値はシステム設定依存となるが、通常は \fI/usr/share/zoneinfo\fP である。
-.LP
-このタイムゾーンディレクトリには以下のファイルが含まれる。
-
-.nf
-    localtime      ローカルタイムゾーンのファイル
-    posixrules     POSIX 式の TZ 書式ルール
-.fi
-.LP
-\fI/etc/localtime\fP は、 \fIlocaltime\fP
-ファイルやシステムのタイムゾーンディレクトリ中の適切なタイムゾーンファイルへのシンボリックリンクであることが多い。
+.TP 
+\fB/etc/localtime\fP
+システムのタイムゾーンファイル。
+.TP 
+\fB/usr/share/zoneinfo/\fP
+The system timezone database directory.
+.TP 
+\fB/usr/share/zoneinfo/posixrules\fP
+When a TZ string includes a dst timezone without anything following it, then
+this file is used for the start/end rules.  It is in the \fBtzfile\fP(5)
+format.  By default, the zoneinfo Makefile hard links it to the
+\fIAmerica/New_York\fP tzfile.
+.PP
+Above are the current standard file locations, but they are configurable
+when glibc is compiled.
 .SH 準拠
 SVr4, POSIX.1\-2001, 4.3BSD.
 .SH 注意
@@ -177,6 +189,6 @@ SVr4, POSIX.1\-2001, 4.3BSD.
 \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.78 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。