138 lines
3.6 KiB
Groff
138 lines
3.6 KiB
Groff
.\" %FreeBSD: src/lib/libc/stdtime/tzfile.5,v 1.10 2001/07/10 13:41:23 ru Exp %
|
|
.\" $FreeBSD$
|
|
.Dd September 13, 1994
|
|
.Dt TZFILE 5
|
|
.Os
|
|
.Sh 名称
|
|
.Nm tzfile
|
|
.Nd タイムゾーンの情報
|
|
.Sh 書式
|
|
.Fd #include \&"/usr/src/lib/libc/stdtime/tzfile.h\&"
|
|
.Sh 解説
|
|
.Xr tzset 3
|
|
が使用するタイムゾーン情報ファイルは、
|
|
タイムゾーン情報ファイルであることを識別するマジック文字列
|
|
.Dq Li TZif
|
|
から始まり、
|
|
将来の使用のために予約された 16 バイトが続き、
|
|
4 つの 4 バイト値が続きます。
|
|
これは ``標準'' バイトオーダ (上位バイトを最初に格納) で格納されます。
|
|
これらの値を順序に従い、以下に示します。
|
|
.Pp
|
|
.Bl -tag -compact -width tzh_ttisstdcnt
|
|
.It Va tzh_ttisgmtcnt
|
|
ファイルに格納された、UTC/ローカル指示子の数。
|
|
.It Va tzh_ttisstdcnt
|
|
ファイルに格納された、標準/ウォール指示子の数。
|
|
.It Va tzh_leapcnt
|
|
ファイルに格納された、閏秒データの数。
|
|
.It Va tzh_timecnt
|
|
ファイルに格納された ``遷移時刻'' データの数。
|
|
.It Va tzh_typecnt
|
|
ファイルに格納された ``ローカルタイム型'' データの数 (0 であってはなりません)。
|
|
.It Va tzh_charcnt
|
|
ファイルに格納された ``タイムゾーン省略形文字列'' の文字数。
|
|
.El
|
|
.Pp
|
|
上記のヘッダに続いて、
|
|
4 バイト
|
|
.Fa long
|
|
型の値が
|
|
.Va tzh_timecnt
|
|
個、昇順に並びます。
|
|
値は ``標準'' バイトオーダで格納されます。
|
|
それぞれ、ローカルタイム計算方法が変わる遷移時刻 (
|
|
.Xr time 3
|
|
で返される形式) として使用されます。
|
|
続いて、1 バイト
|
|
.Fa "unsigned char"
|
|
型の値が
|
|
.Va tzh_timecnt
|
|
個続きます。
|
|
このそれぞれは、同一インデックスの遷移時刻に、
|
|
ファイル中のどの ``ローカルタイム'' 型が対応するかを示します。
|
|
値は、このファイル中で後続する
|
|
.Fa ttinfo
|
|
構造体の配列に対するインデックスです。
|
|
.\" つまり struct ttinfo が tzh_typecnt 個あるということ
|
|
.\" See src/lib/libc/stdtime/tzfile.h
|
|
.\" 1998/05/01 horikawa@jp.freebsd.org
|
|
この構造体の定義を以下に示します。
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
struct ttinfo {
|
|
long tt_gmtoff;
|
|
int tt_isdst;
|
|
unsigned int tt_abbrind;
|
|
};
|
|
.Ed
|
|
.Pp
|
|
各構造体は、
|
|
標準バイトオーダの 4 バイト
|
|
.Fa long
|
|
型の値
|
|
.Va tt_gmtoff
|
|
、それに続く 1 バイトの値
|
|
.Va tt_isdst
|
|
、そして 1 バイトの値
|
|
.Va tt_abbrind
|
|
の順に格納されます。
|
|
.Va tt_gmtoff
|
|
は UTC に加えるべき秒数を、
|
|
.Va tt_isdst
|
|
は
|
|
.Va tm_isdst
|
|
が
|
|
.Xr localtime 3
|
|
により設定されるべきかどうかを、
|
|
.Va tt_abbrind
|
|
はタイムゾーン省略文字列の配列に対するインデックスを意味します。
|
|
タイムゾーン省略文字列の配列は、同一ファイル中の
|
|
.Li ttinfo
|
|
構造体に後続しています。
|
|
.Pp
|
|
その後には標準バイトオーダで格納される 4 バイト値のペアが
|
|
.Va tzh_leapcnt
|
|
個格納されています。
|
|
各ペアの最初の値は、閏秒が発生する時刻 (
|
|
.Xr time 3
|
|
で返される形式) です。
|
|
2 番目の値は、
|
|
指定された時刻以降に適用される閏秒の
|
|
.Em 総計
|
|
です。
|
|
値のペアは時刻の昇順で格納されます。
|
|
.Pp
|
|
その後に、1 バイト値の標準/ウォールの指示子が
|
|
.Va tzh_ttisstdcnt
|
|
個格納されています。
|
|
これらは、ローカルタイム型に関する遷移時刻が
|
|
標準時刻で指定されているのか、
|
|
それともウォールクロックの時刻で指定されているのかを示します。
|
|
この情報は、POSIX スタイルのタイムゾーン環境変数を扱う際に、
|
|
タイムゾーンファイルを使用するときに使用します。
|
|
.Pp
|
|
最後に、複数の
|
|
.Va tzh_ttisgmtcnt
|
|
UTC/ローカル指示子があり、それぞれ 1 バイト値として格納されます。
|
|
これらは、ローカル時刻タイプと関連付けられた遷移時刻が
|
|
UTC とローカル時刻のどちらで指定されているかを示し、
|
|
タイムゾーンファイルが POSIX スタイルタイムゾーン環境変数を扱うときに
|
|
使用されます。
|
|
.Pp
|
|
.Li tzh_timecnt
|
|
が 0 の場合もしくは時刻引数がファイル中の最初の遷移時刻以前の場合、
|
|
.Nm localtime
|
|
は、ファイル中の最初の標準時間の
|
|
.Li ttinfo
|
|
構造体を使用します
|
|
(標準時間の構造体が無い場合には、単に最初の
|
|
.Li ttinfo
|
|
構造体を使用します)。
|
|
.Sh 関連項目
|
|
.Xr ctime 3 ,
|
|
.Xr time2posix 3 ,
|
|
.Xr zic 8
|
|
.\" @(#)tzfile.5 7.2
|
|
.\" This file is in the public domain, so clarified as of
|
|
.\" 1996-06-05 by Arthur David Olson (arthur_david_olson@nih.gov).
|