manページ  — TIME2POSIX

通常は、タイプ time_t は (ほとんどの場合) 不透明なので — すなわち time_t 値は time(3), localtime(3), mktime(3), difftime(3) などの関数からのみ取得し、またそれらの関数のみに渡すように 考えられているので — このことは問題になりません。 しかしながら、 IEEE Std 1003.1-88 ("POSIX.1") は、日付/時間から time_t 値を直接計算する数式を与えており、 プログラムによってはこの関係を前提条件にしているものがあります。 通常、この関係を使って time_t の作成/分析を行っているプログラムでは、 うるう秒をまたがる間隔を正しく処理できません。

time2posix() および posix2time() 関数は、ローカルの time_t 値とそれに相当する POSIX 等価の値との間で 変換を行って、この time_t のミスマッチに対応するために 用意されたものです。これは、うるう秒の挿入や 削除に応じて POSIX システムに起きたタイムベース変更の回数を数える ことにより行います。これらの変換値は、 古いアプリケーションを訂正する代りに、あるいは POSIX 準拠システムと 通信するときに用いることができます。

time2posix() 関数は単一の値を持ちます。すなわち、すべてのローカルの time_t は、 単一の POSIX time_t に対応します。 posix2time() 関数の動作は、それほど行儀よくありません。 正のうるう秒に出会うとその結果は 1 つにはならず、 また負のうるう秒に対しては対応する time_t が存在しないために それに近い値が返されます。これらの 2 つの例は、POSIX による 表現の欠陥度を示すよい指標であるといえます。

次の表は、1993 年 6 月末に挿入されたうるう秒に対して、time_t と その POSIX 表現への変換値、およびそれを再変換して戻した値との関係を示します。

DATE Ta TIME Ta T Ta X=time2posix(T)	posix2time(X)
93/06/30 Ta 23:59:59 Ta A+0 Ta B+0	A+0
93/06/30 Ta 23:59:60 Ta A+1 Ta B+1	A+1 or A+2
93/07/01 Ta 00:00:00 Ta A+2 Ta B+1	A+1 or A+2
93/07/01 Ta 00:00:01 Ta A+3 Ta B+2	A+3

うるう秒削除は次のようになります。

DATE Ta TIME Ta T Ta X=time2posix(T)	posix2time(X)
??/06/30 Ta 23:59:58 Ta A+0 Ta B+0	A+0
??/07/01 Ta 00:00:00 Ta A+1 Ta B+2	A+1
??/07/01 Ta 00:00:01 Ta A+2 Ta B+3	A+2

うるう秒サポートが有効になっていない場合は、 ローカルの time_t と POSIX の time_t は等価となり、 time2posix() および posix2time() 関数はともに恒等関数となります。