OSDN Git Service

Convert release and draft pages to UTF-8.
[linuxjm/jm.git] / manual / LDP_man-pages / draft / man8 / zic.8
1 .\" This page is in the public domain
2 .\"
3 .\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
4 .\" Translated Sat Aug 14 1999
5 .\"       by NAKANO Takeo <nakano@apm.seikei.ac.jp>
6 .\" Updated Wed Apr 4 2001 
7 .\"       by Yuichi SATO <ysato@h4.dion.ne.jp>
8 .\"
9 .\"WORD:        time value              時刻値
10 .\"WORD:        rule line               ルール行
11 .\"WORD:        zone line               ゾーン行
12 .\"WORD:        link line               リンク行
13 .\"WORD:        continuation line       継続行
14 .\"WORD:        wall clock (time)       壁時計 (時刻)
15 .\"WORD:        standard (time)         標準 (時刻)
16 .\"
17 .TH ZIC 8 2010-02-25 "" "Linux System Administration"
18 .\"O .SH NAME
19 .SH 名前
20 .\"O zic \- timezone compiler
21 zic \- タイムゾーンコンパイラ
22 .\"O .SH SYNOPSIS
23 .SH 書式
24 .B zic
25 [
26 .B \-v
27 ] [
28 .B \-d
29 .I directory
30 ] [
31 .B \-l
32 .I localtime
33 ] [
34 .B \-p
35 .I posixrules
36 ] [
37 .B \-L
38 .I leapsecondfilename
39 ] [
40 .B \-s
41 ] [
42 .B \-y
43 .I command
44 ] [
45 .I filename
46 \&... ]
47 .\"O .SH DESCRIPTION
48 .SH 説明
49 .if t .ds lq ``
50 .if t .ds rq ''
51 .if n .ds lq \&"\"
52 .if n .ds rq \&"\"
53 .de q
54 \\$3\*(lq\\$1\*(rq\\$2
55 ..
56 .\"O .I Zic
57 .\"O reads text from the file(s) named on the command line
58 .\"O and creates the time conversion information files specified in this input.
59 .\"O If a
60 .\"O .I filename
61 .\"O is
62 .\"O .BR \- ,
63 .\"O the standard input is read.
64 .I zic
65 はコマンドラインで指定されたファイル (複数指定可) からテキストを読み、
66 時刻変換情報ファイルを生成する。ファイル名も読み込みテキストで指定しておく。
67 .I filename
68
69 .B \-
70 の場合は、標準入力から読み込む。
71 .PP
72 .\"O These options are available:
73 以下のオプションを指定できる:
74 .TP
75 .BI "\-d " directory
76 .\"O Create time conversion information files in the named directory rather than
77 .\"O in the standard directory named below.
78 時刻変換情報ファイルを生成するディレクトリを、標準のディレクトリ
79 (以下を参照) ではなく指定したディレクトリにする。
80 .TP
81 .BI "\-l " timezone
82 .\"O Use the given timezone as local time.
83 .\"O .I Zic
84 .\"O will act as if the input contained a link line of the form
85 指定したタイムゾーンをローカルタイムに用いる。
86 .I zic
87 は入力に以下の書式のリンク行が含まれているかのように振る舞う。
88 .sp
89 .ti +.5i
90 Link    \fItimezone\fP          localtime
91 .TP
92 .BI "\-p " timezone
93 .\"O Use the given timezone's rules when handling POSIX-format
94 .\"O timezone environment variables.
95 .\"O .I Zic
96 .\"O will act as if the input contained a link line of the form
97 POSIX 形式のタイムゾーン環境変数を扱うとき、
98 指定したタイムゾーンのルールを用いる。
99 .I zic
100 は入力に以下の書式のリンク行が含まれているかのように振る舞う。
101 .sp
102 .ti +.5i
103 Link    \fItimezone\fP          posixrules
104 .TP
105 .BI "\-L " leapsecondfilename
106 .\"O Read leap second information from the file with the given name.
107 .\"O If this option is not used,
108 .\"O no leap second information appears in output files.
109 閏秒情報を与えられた名前のファイルから読み込む。
110 このオプションが指定されなかった場合には、
111 出力ファイルには閏秒の情報は含まれない。
112 .TP
113 .B \-v
114 .\"O Complain if a year that appears in a data file is outside the range
115 .\"O of years representable by
116 .\"O .BR time (2)
117 .\"O values.
118 データファイルに現れる年が
119 .BR time (2)
120 で表記できる範囲を越えている場合に文句を言う。
121 .TP
122 .B \-s
123 .\"O Limit time values stored in output files to values that are the same
124 .\"O whether they're taken to be signed or unsigned.
125 .\"O You can use this option to generate SVVS-compatible files.
126 出力ファイルに格納される時刻の値を、 signed で評価しても unsigned で
127 評価しても同じ値になるような範囲に制限する。
128 このオプションを使うと SVVS 互換なファイルを生成することができる。
129 .TP
130 .BI "\-y " command
131 .\"O Use the given
132 .\"O .I command
133 .\"O rather than
134 .\"O .B yearistype
135 .\"O when checking year types (see below).
136 年の型のチェック (以下参照) に
137 .B yearistype
138 ではなく指定した
139 .I command
140 を用いる。
141 .PP
142 .\"O Input lines are made up of fields.
143 .\"O Fields are separated from one another by any number of white space characters.
144 .\"O Leading and trailing white space on input lines is ignored.
145 .\"O An unquoted sharp character (#) in the input introduces a comment which extends
146 .\"O to the end of the line the sharp character appears on.
147 .\"O White space characters and sharp characters may be enclosed in double quotes
148 .\"O (") if they're to be used as part of a field.
149 .\"O Any line that is blank (after comment stripping) is ignored.
150 .\"O Nonblank lines are expected to be of one of three types:
151 .\"O rule lines, zone lines, and link lines.
152 入力行はフィールドからなる。
153 フィールド間は、連続した任意の個数の空白文字によって区切られる。
154 行頭・行末の空白文字は無視される。
155 クォートされていないシャープ文字 (#) が入力行に現れた場合は、
156 そこから行末まではコメントとして扱われる。
157 空白文字やシャープ文字をダブルクォート (") で囲めば、
158 フィールドの一部として用いることができる。
159 (コメント除去処理を行った後のものを含めて) 空行は無視される。
160 空行以外の行は、 3 種類あるタイプの行のいずれかであるとみなされる。
161 3 つのタイプとは、ルール行 (rule line)、ゾーン行 (zone line)、
162 リンク行 (link line) である。
163 .PP
164 .\"O A rule line has the form
165 ルール行の書式は以下のようなものである。
166 .nf
167 .ti +.5i
168 .ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
169 .sp
170 Rule    NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
171 .sp
172 .\"O For example:
173 例:
174 .ti +.5i
175 .sp
176 Rule    US      1967    1973    \-      Apr     lastSun 2:00    1:00    D
177 .sp
178 .fi
179 .\"O The fields that make up a rule line are:
180 ルール行を構成するフィールドは以下の通り:
181 .TP "\w'LETTER/S'u"
182 .B NAME
183 .\"O Gives the (arbitrary) name of the set of rules this rule is part of.
184 このルールが所属するルールセットの名前を与える (任意)。
185 .TP
186 .B FROM
187 .\"O Gives the first year in which the rule applies.
188 .\"O Any integer year can be supplied; the Gregorian calendar is assumed.
189 .\"O The word
190 .\"O .I minimum
191 .\"O (or an abbreviation) means the minimum year representable as an integer.
192 .\"O The word
193 .\"O .I maximum
194 .\"O (or an abbreviation) means the maximum year representable as an integer.
195 .\"O Rules can describe times that are not representable as time values,
196 .\"O with the unrepresentable times ignored; this allows rules to be portable
197 .\"O among hosts with differing time value types.
198 このルールが適用される最初の年を与える。
199 任意の整数を年として与えることができる。グレゴリオ暦が仮定される。
200 .I minimum
201 (あるいはその短縮) は整数表記できる最小の年を意味する。
202 .I maximum
203 (あるいはその短縮) は整数表記できる最大の年を意味する。
204 ルールでは時刻値 (time value) では表記できない時刻も記述できる。
205 表記できない時刻は無視される。つまりルールは
206 異なった時刻値の型を持つホスト間でポータブルである。
207 .TP
208 .B TO
209 .\"O Gives the final year in which the rule applies.
210 .\"O In addition to
211 .\"O .I minimum
212 .\"O and
213 .\"O .I maximum
214 .\"O (as above),
215 .\"O the word
216 .\"O .I only
217 .\"O (or an abbreviation)
218 .\"O may be used to repeat the value of the
219 .\"O .B FROM
220 .\"O field.
221 このルールが適用される最後の年を与える。
222 .I minimum
223
224 .I maximum
225 (上述) に加え、
226 .I only
227 (またはその短縮) を用いることができ、この場合は
228 .B FROM
229 フィールドに指定した値と同じ値が用いられる。
230 .TP
231 .B TYPE
232 .\"O Gives the type of year in which the rule applies.
233 .\"O If
234 .\"O .B TYPE
235 .\"O is
236 .\"O .B \-
237 .\"O then the rule applies in all years between
238 .\"O .B FROM
239 .\"O and
240 .\"O .B TO
241 .\"O inclusive.
242 .\"O If
243 .\"O .B TYPE
244 .\"O is something else, then
245 .\"O .I zic
246 .\"O executes the command
247 ルールの適用される年のタイプを与える。
248 .B TYPE
249
250 .B \-
251 であれば、このルールは
252 .B FROM
253 から
254 .B TO
255 に挟まれた (両端含む) 全ての年に適用される。
256 .B TYPE
257 がそれ以外の場合には、
258 .I zic
259 は以下のコマンドを実行して年のタイプをチェックする。
260 .ti +.5i
261 \fByearistype\fP \fIyear\fP \fItype\fP
262 .br
263 .\"O to check the type of a year:
264 .\"O an exit status of zero is taken to mean that the year is of the given type;
265 .\"O an exit status of one is taken to mean that the year is not of the given type.
266 返り値が 0 の場合は、その年は与えられたタイプに含まれ、
267 返り値が 1 の場合は含まれないことになる。
268 .TP
269 .B IN
270 .\"O Names the month in which the rule takes effect.
271 .\"O Month names may be abbreviated.
272 ルールが効力を持つ月の名前を指定する。
273 月名は短縮できる。
274 .TP
275 .B ON
276 .\"O Gives the day on which the rule takes effect.
277 .\"O Recognized forms include:
278 ルールが効力を持つ日の名前を指定する。
279 以下のような書式を認識する:
280 .nf
281 .in +.5i
282 .sp
283 .ta \w'Sun<=25\0\0'u
284 .\"O 5  the fifth of the month
285 .\"O lastSun    the last Sunday in the month
286 .\"O lastMon    the last Monday in the month
287 .\"O Sun>=8     first Sunday on or after the eighth
288 .\"O Sun<=25    last Sunday on or before the 25th
289 5       その月の第 5 日
290 lastSun その月の最後の日曜日
291 lastMon その月の最後の月曜日
292 Sun>=8  第 8 日以降の最初の日曜日
293 Sun<=25 第 25 日以前の最後の日曜日
294 .fi
295 .in -.5i
296 .sp
297 .\"O Names of days of the week may be abbreviated or spelled out in full.
298 .\"O Note that there must be no spaces within the
299 .\"O .B ON
300 .\"O field.
301 曜日の名前は短縮できる。全部綴っても良い。
302 .B ON
303 フィールドの内部にはスペースを入れてはいけないことに注意。
304 .TP
305 .B AT
306 .\"O Gives the time of day at which the rule takes effect.
307 .\"O Recognized forms include:
308 ルールが効力を持つ一日のうちの時刻を与える。
309 以下のような書式を認識する:
310 .nf
311 .in +.5i
312 .sp
313 .ta \w'1:28:13\0\0'u
314 .\"O 2  time in hours
315 .\"O 2:00       time in hours and minutes
316 .\"O 15:00      24-hour format time (for times after noon)
317 .\"O 1:28:14    time in hours, minutes, and seconds
318 .\"O \- equivalent to 0
319 2       時間での表記
320 2:00    時間と分での表記
321 15:00   24 時間形式の時間 (正午以降)
322 1:28:14 時間・分・秒での表記
323 \-      0 と同じ
324 .fi
325 .in -.5i
326 .sp
327 .\"O where hour 0 is midnight at the start of the day,
328 .\"O and hour 24 is midnight at the end of the day.
329 .\"O Any of these forms may be followed by the letter
330 .\"O .I w
331 .\"O if the given time is local
332 .\"O .q "wall clock"
333 .\"O time,
334 .\"O .I s
335 .\"O if the given time is local
336 .\"O .q standard
337 .\"O time, or
338 .\"O .I u
339 .\"O (or
340 .\"O .I g
341 .\"O or
342 .\"O .IR z )
343 .\"O if the given time is universal time;
344 .\"O in the absence of an indicator,
345 .\"O wall clock time is assumed.
346 ここで 0 時はその日のはじまりであり、
347 24 時はその日の終わりである。
348 これらの書式のあとには、以下の文字のいずれかを指定することができる。
349 .I w
350 与えられた時刻がローカルな
351 .q "壁時計 (wall clock)"
352 時刻である;
353 .I s
354 与えられた時刻がローカルな
355 .q "標準 (standard)"
356 時刻である;
357 .I u
358 (または
359 .I g
360 または
361 .IR z )
362 与えられた時刻が標準時 (universal time) である。
363 これらの表意文字がいずれも指定されなかった場合は、
364 壁時計時刻が仮定される。
365 .TP
366 .B SAVE
367 .\"O Gives the amount of time to be added to local standard time when the rule is in
368 .\"O effect.
369 .\"O This field has the same format as the
370 .\"O .B AT
371 .\"O field
372 .\"O (although, of course, the
373 .\"O .I w
374 .\"O and
375 .\"O .I s
376 .\"O suffixes are not used).
377 ルールが効力を持っているとき、ローカルな標準時刻に追加すべき
378 時間の量を与える。このフィールドの書式は
379 .B AT
380 フィールドのものと同じである (ただしもちろん
381 .I w
382
383 .I s
384 の後置文字は用いられない)。
385 .TP
386 .B LETTER/S
387 .\"O Gives the
388 .\"O .q "variable part"
389 .\"O (for example, the
390 .\"O .q S
391 .\"O or
392 .\"O .q D
393 .\"O in
394 .\"O .q EST
395 .\"O or
396 .\"O .q EDT )
397 .\"O of timezone abbreviations to be used when this rule is in effect.
398 .\"O If this field is
399 .\"O .BR \- ,
400 .\"O the variable part is null.
401 このルールが効力を持っている場合に用いられるタイムゾーン短縮型の
402 .q "可変部 (variable part)
403 を与える (例えば
404 .q EST
405
406 .q EDT
407 における
408 .q S
409
410 .q D
411 など)。
412 このフィールドが
413 .B \-
414 であった場合には、
415 可変部は存在しない。
416 .PP
417 .\"O A zone line has the form
418 ゾーン行の書式は以下のようなものである。
419 .sp
420 .nf
421 .ti +.5i
422 .ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'UTCOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
423 Zone    NAME    UTCOFF  RULES/SAVE      FORMAT  [UNTIL]
424 .sp
425 .\"O For example:
426 例:
427 .sp
428 .ti +.5i
429 Zone    Australia/Adelaide      9:30    Aus     CST     1971 Oct 31 2:00
430 .sp
431 .fi
432 .\"O The fields that make up a zone line are:
433 ゾーン行を構成するフィールドは以下の通り:
434 .TP "\w'UTCOFF'u"
435 .B NAME
436 .\"O The name of the timezone.
437 .\"O This is the name used in creating the time conversion information file for the
438 .\"O zone.
439 タイムゾーンの名前。この名前がこのゾーンの時刻変換情報ファイルを
440 生成するときに用いられる。
441 .TP
442 .B UTCOFF
443 .\"O The amount of time to add to UTC to get standard time in this zone.
444 .\"O This field has the same format as the
445 .\"O .B AT
446 .\"O and
447 .\"O .B SAVE
448 .\"O fields of rule lines;
449 .\"O begin the field with a minus sign if time must be subtracted from UTC.
450 このゾーンの標準時刻を得るために、 UTC に加える時間。
451 このフィールドの書式は、ルール行の
452 .B AT
453 および
454 .B SAVE
455 フィールドのものと同じである。時間を UTC から引く必要がある場合は
456 マイナス記号を前置する。
457 .TP
458 .B RULES/SAVE
459 .\"O The name of the rule(s) that apply in the timezone or,
460 .\"O alternately, an amount of time to add to local standard time.
461 .\"O If this field is
462 .\"O .B \-
463 .\"O then standard time always applies in the timezone.
464 タイムゾーンに適用されるルールの名前か、あるいは
465 ローカル標準時刻に加えるべき時間の量を指定する。
466 このフィールドが
467 .B \-
468 ならば、常に標準時刻がこのゾーンに対して用いられる。
469 .TP
470 .B FORMAT
471 .\"O The format for timezone abbreviations in this timezone.
472 .\"O The pair of characters
473 .\"O .B %s
474 .\"O is used to show where the
475 .\"O .q "variable part"
476 .\"O of the timezone abbreviation goes.
477 .\"O Alternately,
478 .\"O a slash (/)
479 .\"O separates standard and daylight abbreviations.
480 このタイムゾーンに対するタイムゾーン短縮名の書式。
481 2 文字の文字列
482 .B %s
483 を用いて、どこが
484 .q 可変部
485 になるかを指定できる。あるいはスラッシュ文字 (/) を用いて
486 標準の短縮名とサマータイム短縮名を区切ることができる。
487 .TP
488 .B UNTIL
489 .\"O The time at which the UTC offset or the rule(s) change for a location.
490 .\"O It is specified as a year, a month, a day, and a time of day.
491 .\"O If this is specified,
492 .\"O the timezone information is generated from the given UTC offset
493 .\"O and rule change until the time specified.
494 .\"O The month, day, and time of day have the same format as the IN, ON, and AT
495 .\"O columns of a rule; trailing columns can be omitted, and default to the
496 .\"O earliest possible value for the missing columns.
497 UTC に対するオフセットか、その場所におけるルールが変更される時刻。
498 年・月・日・時刻で指定する。
499 これが指定された場合には、タイムゾーンの情報は与えられている
500 UTC オフセットから生成され、ルールは指定時刻になると変更される。
501 月・日・時刻は、ルールの IN, ON, AT カラムと同じ書式で指定する。
502 この後に続くカラムは省略できる。
503 省略されたカラムに対しては、
504 可能性のあるもののうち最も早い値がデフォルトで用いられる。
505 .IP
506 .\"O The next line must be a
507 .\"O .q continuation
508 .\"O line; this has the same form as a zone line except that the
509 .\"O string
510 .\"O .q Zone
511 .\"O and the name are omitted, as the continuation line will
512 .\"O place information starting at the time specified as the
513 .\"O .B UNTIL
514 .\"O field in the previous line in the file used by the previous line.
515 .\"O Continuation lines may contain an
516 .\"O .B UNTIL
517 .\"O field, just as zone lines do, indicating that the next line is a further
518 .\"O continuation.
519 この行には必ず
520 .q 継続 (continuation)
521 行が続く。
522 継続行はゾーン行と同じ書式を持つが、
523 .q Zone
524 と名前は省略される。なぜなら継続行は直前の行の
525 .B UNTIL
526 フィールドで指定された時刻以降の情報を与えるものだからである。
527 継続行にもゾーン行と同じように
528 .B UNTIL
529 フィールドを指定することができ、この場合はその次の行が
530 さらなる継続行になることとなる。
531 .PP
532 .\"O A link line has the form
533 リンク行の書式は以下のようなものである。
534 .sp
535 .nf
536 .ti +.5i
537 .ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u
538 Link    LINK-FROM       LINK-TO
539 .sp
540 .\"O For example:
541 例:
542 .sp
543 .ti +.5i
544 Link    Europe/Istanbul Asia/Istanbul
545 .sp
546 .fi
547 .\"O The
548 .\"O .B LINK-FROM
549 .\"O field should appear as the
550 .\"O .B NAME
551 .\"O field in some zone line;
552 .\"O the
553 .\"O .B LINK-TO
554 .\"O field is used as an alternate name for that zone.
555 .PP
556 .\"O Except for continuation lines,
557 .\"O lines may appear in any order in the input.
558 .B LINK-FROM
559 フィールドはゾーン行の
560 .B NAME
561 フィールドが記述される。
562 .B LINK-TO
563 フィールドはそのゾーンの別名である。
564 .PP
565 .\"O Lines in the file that describes leap seconds have the following form:
566 ファイル中で閏秒を記述する行は以下のような書式を持つ。
567 .nf
568 .ti +.5i
569 .ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u
570 .sp
571 Leap    YEAR    MONTH   DAY     HH:MM:SS        CORR    R/S
572 .sp
573 .\"O For example:
574 例:
575 .ti +.5i
576 .sp
577 Leap    1974    Dec     31      23:59:60        +       S
578 .sp
579 .fi
580 .\"O The
581 .\"O .BR YEAR ,
582 .\"O .BR MONTH ,
583 .\"O .BR DAY ,
584 .\"O and
585 .\"O .B HH:MM:SS
586 .\"O fields tell when the leap second happened.
587 .\"O The
588 .\"O .B CORR
589 .\"O field
590 .\"O should be
591 .\"O .q +
592 .\"O if a second was added
593 .\"O or
594 .\"O .q -
595 .\"O if a second was skipped.
596 .BR YEAR ,
597 .BR MONTH ,
598 .BR DAY ,
599 .B HH:MM:SS
600 は閏秒の生じた瞬間を示す。
601 .B CORR
602 フィールドには、秒が挿入された場合
603 .q +
604 を、秒がスキップされた場合
605 .q -
606 を指定する。
607 .\" There's no need to document the following, since it's impossible for more
608 .\" than one leap second to be inserted or deleted at a time.
609 .\" The C Standard is in error in suggesting the possibility.
610 .\" See Terry J Quinn, The BIPM and the accurate measure of time,
611 .\" Proc IEEE 79, 7 (July 1991), 894-905.
612 .\"     or
613 .\"     .q ++
614 .\"     if two seconds were added
615 .\"     or
616 .\"     .q --
617 .\"     if two seconds were skipped.
618 .\"O The
619 .\"O .B R/S
620 .\"O field
621 .\"O should be (an abbreviation of)
622 .\"O .q Stationary
623 .\"O if the leap second time given by the other fields should be interpreted as UTC
624 .\"O or
625 .\"O (an abbreviation of)
626 .\"O .q Rolling
627 .\"O if the leap second time given by the other fields should be interpreted as
628 .\"O local wall clock time.
629 .B R/S
630 フィールドには、他のフィールドが記述している閏秒の時刻が
631 UTC ならば
632 .q Stationary
633 (あるいはその短縮形) を、ローカルな壁時計時刻なら
634 .q Rolling
635 (あるいはその短縮形) を指定する。
636 .\"O .SH FILES
637 .SH ファイル
638 .\"O /usr/local/etc/zoneinfo    standard directory used for created files
639 /usr/local/etc/zoneinfo         生成されたファイル用の標準ディレクトリ
640 .\"O .SH NOTES
641 .SH 注意
642 .\"O For areas with more than two types of local time,
643 .\"O you may need to use local standard time in the
644 .\"O .B AT
645 .\"O field of the earliest transition time's rule to ensure that
646 .\"O the earliest transition time recorded in the compiled file is correct.
647 二つ以上のローカルタイムを持っている地域では、
648 ローカルな標準時を
649 最も早い方の時刻変換ルールの
650 .B AT
651 フィールドに用いる必要があるだろう。さもないと
652 コンパイルされたファイルに記録された最も早い変換時刻が
653 正しいことが保証されない。
654 .\"O .SH "SEE ALSO"
655 .SH 関連項目
656 .BR tzfile (5),
657 .BR zdump (8)
658 .\" @(#)zic.8   7.19