名前¶

zdump - タイムゾーンをダンプする

書式¶

zdump [ option ... ] [ timezone ... ]

説明¶

zdump プログラムは、コマンドラインで指定された各 timezone の現在の時刻を出力します。- の timezone は /dev/stdin であるかのように扱われます。これを使用して、 TZif データを zdump にパイプできます。

オプション¶

--version

バージョン情報を出力し、終了します。

--help

簡潔な使用方法を表示して、終了します。

-i

インターバルの説明を出力します。コマンドラインで timezone ごとに、インターバル形式のタイムゾーンの説明を出力します。下記の “インターバル形式” を参照してください。

-v

インターバルの詳細な記述を出力します。コマンド行の各 timezone について、時刻の両極端の時刻、 localtime(3) と gmtime(3) が表すことのできる年の境界の時刻(存在する場合)とその境界を少し越えた時刻、および検出された時間の不連続性の 1秒前と 1秒後の時刻を出力します。各行の後には isdst=D が続きます。 D は、指定された時刻が夏時間、標準時、不明な時刻タイプのいずれであるかに応じて、それぞれ正、0、負になります。また、指定された現地時刻がグリニッジの N 秒東であることがわかっている場合は、各行の後に gmtoff=N が続きます。

-V

-v と似ていますが、極端な時間と年の値に関する出力は省略されます。これにより、異なる時間表現を持つ実装と比較しやすい出力が生成されます。

-c [loyear,]hiyear

指定された年の出力の間隔の切捨て。切捨て時間は、グレゴリオ暦の年 0 を使用し、世界時 (UT) では閏秒を無視して計算されます。切捨ては各年の開始時で、下限タイムスタンプはその値を含み、上限はその値を含みません。たとえば、 -c 1970,2070 では 1970-01-01 00:00:00 UTC 以降および 2070-01-01 00:00:00 UTC より前の移行が選択されます。既定値の切捨ては -500,2500です。

-t [lotime,]hitime

1970-01-01 00:00:00 協定世界時 (UTC) からの 10進数の秒数で指定された、指定された時間でのカットオフ間隔の出力。 timezone は、カウントに閏秒が含まれるかどうかを決定します。 -c と同様に、カットオフの下限は包含的で、上限は排他的です。

インターバル形式¶

インターバルの書式は、人間と機械の両方が読めることを意図したコンパクトなテキスト表現です。インターバルの書式は、空行、 “TZ=string” 行 (string はタイムゾーンを示す二重引用符で囲まれた文字列)、2行目の “- - interval” (最初の遷移がある場合はその前のインターバルを記述する)、および 0行以上の後続の行 “date time interval” (各遷移時間と後続のインターバルごとに 1行)で構成されます。フィールドは 1つのタブで区切られます。

日付は yyyy-mm-dd 形式、時刻は hh<24 の 24時間 hh:mm:ss 形式です。時刻は移行直後のローカル時刻です。インターバルの説明は、符号付き ±hhmmss 形式の UT オフセット、タイムゾーンの省略形、および isdst フラグで構成されます。 UT オフセットに等しい省略形は省略されます。他の省略形は、1つ以上のアルファベット文字で構成されていない限り、二重引用符で囲まれた文字列です。isdst フラグは、標準時間の場合は省略されます。それ以外の場合は、符号なしの 10進整数で、夏時間の場合は正の数(通常は 1)、不明の場合は負の数です。

絶対時間が 100時間未満の時刻および UT オフセットでは、秒がゼロの場合は省略され、分もゼロの場合は省略されます。正の UT オフセットは、グリニッジの東です。UT オフセット -00 は、実際のオフセットが指定されていない地域の UT プレースホルダを示します。これは、慣例により、UT オフセットがゼロで、タイムゾーンの省略形が “-” で始まるか、または である場合に発生します。

二重引用符で囲まれた文字列では、エスケープシーケンスは特殊な文字を表します。エスケープシーケンスでは、\s は空白を表し、 \"、\\、\f、\n、\r、\t、および \v は C プログラミング言語での通常の意味を表します。たとえば、二重引用符で囲まれた文字列“"CET\s\"\\"”は、文字シーケンス“CET "\”を表します。

次に、先頭の空行を省略した出力の例を示します(この例では、タブ付きの列が揃うように、タブ位置を十分に離して設定しています)。

TZ="Pacific/Honolulu"
-	-	-103126	LMT
1896-01-13	12:01:26	-1030	HST
1933-04-30	03	-0930	HDT	1
1933-05-21	11	-1030	HST
1942-02-09	03	-0930	HWT	1
1945-08-14	13:30	-0930	HPT	1
1945-09-30	01	-1030	HST
1947-06-08	02:30	-10	HST

以下は、別の例からの抜粋です:

TZ="Europe/Astrakhan"
-	-	+031212	LMT
1924-04-30	23:47:48	+03
1930-06-21	01	+04
1981-04-01	01	+05		1
1981-09-30	23	+04
...
2014-10-26	01	+03
2016-03-27	03	+04

制限¶

時間の不連続性は、 localtime(3) から返された結果を 12時間間隔でサンプリングすることによって検出されます。これはすべての実世界の場合に機能し、これが失敗する人工的なタイムゾーンを構築することができます。

-v と-V の出力では、 “UT” は gmtime(3) によって返された値を示します。 UT は現代のタイムスタンプに UTC を使用し、UTC が導入される前のタイムスタンプには他の UTC フレーバーを使用します。現在のところ、新しいタイムスタンプに “UTC” を、古いタイムスタンプに “ "UT” を使用する試みは行われていません。これは、一部に UTC が導入された正確な日付に問題があるためです。

関連項目¶

tzfile(5), zic(8)