日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
ZIC(8) FreeBSD システム管理者マニュアル ZIC(8)
名称
zic -- タイムゾーンコンパイラ
書式
zic [--version] [-Dsv] [-d directory] [-g group] [-L leapsecondfilename]
[-l localtime] [-m mode] [-p posixrules] [-u user] [-y command]
[filename ...]
解説
zic ユーティリティは、コマンド行で指定された (複数の) ファイルからテキス
トを読み込み、この入力で指定された時間変換情報ファイルを作成します。
filename が - であるなら、標準入力が読み込まれます。
次のオプションが、利用可能です:
--version
バージョン情報を出力して終了します。
-D ディレクトリを自動的に作成しません。(複数の) 入力ファイルが、すで
に存在していないディレクトリの出力ファイルを指定するなら、デフォ
ルトの振る舞いは、ディレクトリを作成することを試みることです。-D
が指定されるなら、zic は、代わりに直ちにエラーを出力します。
-d directory
以下で指定された標準のディレクトリではなく、指定されたディレクト
リの時間変換情報ファイルを作成します。
-g group
各出力ファイルを作成した後に、(名前または数値グループ ID のいずれ
かを指定することができる) 指定された group へのグループの所有権を
変更します。
-L leapsecondfilename
与えられた名前でファイルからうるう秒の情報を読み込みます。このオ
プションが使用されないなら、うるう秒の情報は、出力ファイルに現れ
ません。
-l timezone
ローカル時間として、与えられた time zone (タイムゾーン) を使用し
ます。zic ユーティリティは、あたかも入力が次の形式のリンク行を含
んでいるかのように動作します。
Link timezone localtime
(このアクションは、ローカル時間のゾーンが
/usr/share/zoneinfo/localtime ではなく、/etc/localtime で、指定さ
れるので、FreeBSD で効果がないことに注意してください。)
-m mode
各出力ファイルを作成した後に、mode へのそのアクセスモードを変更し
ます。数値とアルファベット順のモードの両方は、受け付けられます
(chmod(1) を参照)。
-p timezone
POSIX 形式タイムゾーン環境変数を処理するとき、与えられる time
zone (タイムゾーン) の規則を使用します。zic ユーティリティは、あ
たかも入力が次の形式のリンク行を含んでいるかのように動作します。
Link timezone posixrules
-u user
各出力ファイルを作成した後に、その所有者を (名前または数値のユー
ザ ID のいずれかを指定できる) user に変更します
-v データファイルに現れる年が time(3) 値によって表現可能な年の範囲の
外側であるなら、エラーを出します。
-s 出力ファイルに格納される時間値を、それらが、符号付きまたは符号な
しと取られるかにかわらず、同じである値に制限します。利用者は、
SVVS 互換のファイルを生成するために、このオプションを使用すること
ができます。
-y command
年のタイプをチェックするとき、yearistype ではなく、与えられた
command を使用します (以下を参照)。
入力行は、フィールドで構成されています。フィールドは、いくつもの空白類文
字によってお互いに切り離されます。入力行の先導して、後続する空白類は、無
視されます。入力の引用されていないシャープ文字 (#) は、シャープ文字が現れ
る行の終わりまで展開するコメントを取り込みます。空白類文字とシャープ文字
は、それらがフィールドの一部として使用されているなら、ダブルクォート (")
で囲まれます。(コメントが取り除かれた後の) 空白であるあらゆる行は、無視さ
れます。空白でない行は、次の 3 タイプの 1 つであると予想されます: 規則
行、ゾーン行とリンク行。
(月の名前のような) 名前は、英語でなければならなくて、大文字と小文字を区別
しません。使用されるなら、省略形は、コンテキストで明白でなければなりませ
ん。
規則行は、次の形式があります:
Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S
例えば:
Rule US 1967 1973 - Apr lastSun 2:00 1:00 D
規則行を構成するフィールドは、次の通りです:
NAME この規則が一部である、規則の集合の (任意の) 名前を与えま
す。
FROM 規則が適用する最初の年を与えます。あらゆる整数の年を供給
することができます。グレゴリオ暦が、仮定されます。単語
minimum (または短縮形) は、整数として表現可能な最小の年を
意味します。単語 maximum (または短縮形) は、整数として表
現可能な最大の年を意味します。規則は、無視される表現可能
ではない時間がある、時間値として表現可能ではない時間を記
述することができます。これによって、規則は、異なる時間の
値のタイプがあるホストの間で移植性があることを可能にしま
す。
TO 規則が適用される最後の年を与えます。minimum と maximum
(上記のような) に加えて、単語 only (または短縮形) は、
FROM フィールドの値を繰り返すために使用されます。
TYPE 規則が適用される年のタイプを与えます。TYPE が - であるな
ら、規則は、両端を含めて FROM と TO の間のすべての年に適
用されます。TYPE が何か他であるなら、zic は、年のタイプを
チェックするために、コマンド yearistype year type を実行
します: 0 の終了ステータスは、年が、与えられたタイプであ
ることを意味すると解釈されます。1 の終了ステータスは、年
が、与えられたタイプでないことを意味すると解釈されます。
IN 規則が効力を生じる月に名前を付けます。月の名前は、短縮形
となります。
ON 規則が効果を生じる日を与えます。認識される形式は、次を含
みます:
5 月の 5 日。
lastSun 月の最後の日曜日。
lastMon 月の最後の月曜日。
Sun>=8 最初の日曜日または 8 日の後。
Sun<=25 最後の日曜日または 25 日の前。
週の日の名前は、短縮形とされるか、または全体の文字を略さ
ないようなります。ON フィールド内に空白があってはならない
ことに注意してください。
AT 規則の効果が生じる日の時間を与えます。認識される形式は、
次を含みます:
2 時間の時。
2:00 時間と時と分。
15:00 24 時間形式の時 (正午の後の時間に対して)。
1:28:14 時間の時、分、と秒。
ここで、0 時は、日の開始の真夜中であり、24 時は、日の終り
の真夜中です。これらの形式のいずれも、与えられた時間が
ローカルな ``wall clock'' (掛け時計) 時間であるなら、文字
`w' が続き、与えられた時間がローカルな ``standard'' (標
準) であるなら、`s' が続き、または与えられた時が世界標準
時であるなら、`u' (または `g' または `z') が続きます。指
定子が存在しない場合、掛け時計が、仮定されます。
SAVE 規則に効果が生じるとき、ローカルな標準時に追加される時間
の量を与えます。このフィールドは、AT フィールドと同じ形式
があります (が、もちろん、`w' と `s' 接尾辞は、使用されま
せん)。
LETTER/S この規則が効果を生じるとき、使用されるタイムゾーンの短縮
形の ``variable part'' (変数部分) (例えば、``EST'' または
``EDT'' の ``S'' または ``D'') を与えます。このフィールド
が - であるなら、変数の部分は、null です。
ゾーン行は、次の形式があります:
Zone NAME GMTOFF RULES/SAVE FORMAT [UNTILYEAR [MONTH [DAY
[TIME]]]]
例えば:
Zone Australia/Adelaide 9:30 Aus CST 1971 Oct 31 2:00
ゾーン行を構成するフィールドは、次の通りです:
NAME タイムゾーンの名前。これは、ゾーンのための時間変換情報ファイルを
作成する時に使用される名前です。
GMTOFF このゾーンで標準時を取得するために UTC に追加する時間の量。この
フィールドは、規則行の AT と SAVE フィールドと同じ形式がありま
す。時間が UTC から引かなければならないなら、マイナス記号でフィー
ルドを開始します。
RULES/SAVE
タイムゾーンに適用される (複数の) 規則の名前、またはまたは交互
に、ローカルな標準時に追加する時間の量。このフィールドが - である
なら、標準時は、常にタイムゾーンで適用されます。
FORMAT このタイムゾーンのタイムゾーンの短縮形のための形式。文字 %s のペ
アは、タイムゾーンの短縮形の ``variable part'' (変数部分) がどこ
に行くかを表示するために使用されます。もう一つとして、スラッシュ
(/) は、標準時と夏時間の短縮形を切り離します。
UNTILYEAR [MONTH [DAY [TIME]]]
UTC オフセットまたは場所のために変更される (複数の) 規則の時間。
それは、年、月、日、と日の時刻として指定されます。これが指定され
るなら、タイムゾーン情報は、指定された時間まで、与えられた UTC オ
フセットと規則変更から生成されます。月、日と時刻は、IN、ON と規則
の AT フィールドと同じ形式があります。後続するフィールドを省略す
ることができ、失われたフィールドのための最も早い可能な値をデフォ
ルトとします。
次の行は、``continuation'' (連続) 行でなければなりません。これ
は、連続行が、以前の行によって使用されたファイルの以前の行の
until 情報として指定された時間に始まる情報を置くように、文字列
``Zone'' と名前が省略されることを除いて、ゾーン行と同じ形式があり
ます。連続行は、次の行がさらなる連続であることを示して、ちょうど
ゾーン行が行なうように、until 情報を含みます。
リンク行には、次の形式があります。
Link LINK-FROM LINK-TO
例えば:
Link Europe/Istanbul Asia/Istanbul
LINK-FROM フィールドは、いくつかのゾーン行の NAME フィールドとして荒割る
べきです。LINK-TO フィールドは、そのゾーンのための代替の名前として使用さ
れます。
連続行を除いて、行は、入力であらゆる順序で現れます。
うるう秒を記述するファイルの行は、次の形式があります:
Leap YEAR MONTH DAY HH:MM:SS CORR R/S
例えば:
Leap 1974 Dec 31 23:59:60 + S
YEAR, MONTH, DAY と HH:MM:SS フィールドは、うるう秒が起こったとき、伝えま
す。CORR フィールドは、秒が追加されたなら、``+'' または秒がスキップされた
なら、``-'' であるべきです。R/S フィールドは、他のフィールドによって与え
られたうるう秒の時間が UTC と解釈されるべきであるなら、``Stationary'' (の
短縮形) であるべきです、または他のフィールドによって与えられたうるう秒の
時間がローカルな壁掛けクロック時間として解釈されるべきであるなら、
``Rolling'' (の短縮形) であるべきです。
拡張された例
ここに、zic 入力の拡張された例を示します、その機能の多くを説明することを
目的としています。
# Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S
Rule Swiss 1940 only - Nov 2 0:00 1:00 S
Rule Swiss 1940 only - Dec 31 0:00 0 -
Rule Swiss 1941 1942 - May Sun>=1 2:00 1:00 S
Rule Swiss 1941 1942 - Oct Sun>=1 0:00 0
Rule EU 1977 1980 - Apr Sun>=1 1:00u 1:00 S
Rule EU 1977 only - Sep lastSun 1:00u 0 -
Rule EU 1978 only - Oct 1 1:00u 0 -
Rule EU 1979 1995 - Sep lastSun 1:00u 0 -
Rule EU 1981 max - Mar lastSun 1:00u 1:00 S
Rule EU 1996 max - Oct lastSun 1:00u 0 -
# Zone NAME GMTOFF RULES FORMAT UNTIL
Zone Europe/Zurich 0:34:08 - LMT 1848 Sep 12
0:29:44 - BMT 1894 Jun
1:00 Swiss CE%sT 1981
1:00 EU CE%sT
Link Europe/Zurich Switzerland
この例で、ゾーンは、Europe/Zurich 名前が付けられていますが、それは、
Switzerland として別名があります。Zurich は、オフセットが 29 分と 44 秒に
変更されたとき、1848-09-12 年の 00 時 00 分まで、GMT (世界標準時) の 34
分と 8 秒西でした。1894-06-01 年の 00 時 00 分の後に、("Rule Swiss" で始
まる行で定義される) Swiss 夏時間規則は、適応され、GMT (世界標準時) のオフ
セットは、1 時間になります。1981 から現在まで、EU 夏時間規則は、適用さ
れ、UTC オフセットは、1 時間のままとなります。
1940 年に、夏時間は、11 月 2 日の 00 時 00 分から 12 月 31 日の 00 時 00
分まで適用しました。1941 年と 1942 年に、夏時間は、5 月の最初の日曜日の
02 時 00 分から 10 月の最初の日曜日の 00 時 00 分まで適用されます。1981
年以前の EU の夏時間規則は、ここで効果がありませんが、完全性のために含ま
れます。1981 年以来、夏時間は、最後の日曜日の 3 月の 01 時 00 分 UTC に始
まります。1995 年まで、それは、9 月の最後の日曜日の 01 時 00 分 UTC に終
了しますが、これは、1996 年に始まる 10 月の最後の日曜日に変更しました。
表示の目的のために、"LMT" と "BMT" は、それぞれ、最初に使用されました。
Swiss の規則と後の EU 規則は、適用されて以来、タイムゾーンのための表示名
は、標準時間のための CET と夏時間のための CEST です。
注
ローカル時間の 2 つのタイプを超える領域のために、利用者は、コンパイルされ
たファイルに記録された最も早い遷移時間が正しいことを保証するために最も早
い遷移時間の規則の AT フィールドでローカルな標準時間を使用する必要があり
ます。
特定のゾーンのために、夏時間の開始によって起こされたクロックを進めること
が、一致し、UTC オフセットの変更に起因するクロックの後退と等しいなら、zic
は、(壁掛けクロック時間のあらゆる変更なしで) 新しい UTC オフセットで夏時
間に単一の遷移を引き起こします。個別の遷移を取得するために、世界時間を使
用して遷移の瞬間を指定して複数ゾーンの連続行を使用します。
関連ファイル
/usr/share/zoneinfo 作成されたファイルのために使用される標準ディレクトリ
関連項目
ctime(3), tzfile(5), zdump(8)
FreeBSD 13.0 June 20, 2004 FreeBSD 13.0