.\" Modified Sat Jul 24 19:49:27 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Fri Apr 26 12:38:55 MET DST 1996 by Martin Schulze (joey@linux.de)
.\" Modified 2001-11-13, aeb
+.\" Modified 2001-12-13, joey, aeb
.\" Modified 2004-11-16, mtk
.\"
-.\" Japanese Version Copyright (c) 1997 Hiroaki Nagoya
-.\" all rights reserved.
-.\" Translated 1997-02-10, Hiroaki Nagoya <nagoya@is.titech.ac.jp>
-.\" Updated 1999-09-01, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-10-15, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-12-13, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2002-01-03, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2008-04-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.79
-.\" Updated 2008-08-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
-.\" Updated 2008-11-10, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.13
+.\"*******************************************************************
.\"
-.\"WORD: Coordinated Univarsal Time 協定世界時
-.\"WORD: broken-down time 要素別の時刻
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH CTIME 3 2010-02-25 "" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH CTIME 3 2010\-02\-25 "" "Linux Programmer's Manual"
.SH 名前
asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r,
localtime_r \- 日付と時刻を要素別の時刻や ASCII に変換する
.SH 書式
.nf
-.B #include <time.h>
+\fB#include <time.h>\fP
.sp
-.BI "char *asctime(const struct tm *" tm );
+\fBchar *asctime(const struct tm *\fP\fItm\fP\fB);\fP
.br
-.BI "char *asctime_r(const struct tm *" tm ", char *" buf );
+\fBchar *asctime_r(const struct tm *\fP\fItm\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.sp
-.BI "char *ctime(const time_t *" timep );
+\fBchar *ctime(const time_t *\fP\fItimep\fP\fB);\fP
.br
-.BI "char *ctime_r(const time_t *" timep ", char *" buf );
+\fBchar *ctime_r(const time_t *\fP\fItimep\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.sp
-.BI "struct tm *gmtime(const time_t *" timep );
+\fBstruct tm *gmtime(const time_t *\fP\fItimep\fP\fB);\fP
.br
-.BI "struct tm *gmtime_r(const time_t *" timep ", struct tm *" result );
+\fBstruct tm *gmtime_r(const time_t *\fP\fItimep\fP\fB, struct tm *\fP\fIresult\fP\fB);\fP
.sp
-.BI "struct tm *localtime(const time_t *" timep );
+\fBstruct tm *localtime(const time_t *\fP\fItimep\fP\fB);\fP
.br
-.BI "struct tm *localtime_r(const time_t *" timep ", struct tm *" result );
+\fBstruct tm *localtime_r(const time_t *\fP\fItimep\fP\fB, struct tm *\fP\fIresult\fP\fB);\fP
.sp
-.BI "time_t mktime(struct tm *" tm );
+\fBtime_t mktime(struct tm *\fP\fItm\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.ad l
.sp
-.BR asctime_r (),
-.BR ctime_r (),
-.BR gmtime_r (),
-.BR localtime_r ():
+\fBasctime_r\fP(), \fBctime_r\fP(), \fBgmtime_r\fP(), \fBlocaltime_r\fP():
.RS
-_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
-_SVID_SOURCE || _POSIX_SOURCE
+_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE
+|| _POSIX_SOURCE
.RE
.ad
.SH 説明
-関数
-.BR ctime (),
-.BR gmtime (),
-.BR localtime ()
-は
-\fItime_t\fP 型のカレンダー時刻を引き数にとる。
-引き数が絶対値として解釈される場合は、時刻紀元 (Epoch;
-1970-01-01 00:00:00 +0000 (UTC)) からの経過秒数と解釈される。
+関数 \fBctime\fP(), \fBgmtime\fP(), \fBlocaltime\fP() は \fItime_t\fP 型のカレンダー時刻を引き数にとる。
+引き数が絶対値として解釈される場合は、時刻紀元 (Epoch; 1970\-01\-01 00:00:00 +0000 (UTC))
+からの経過秒数と解釈される。
.PP
-関数
-.BR asctime ()
-と
-.BR mktime ()
-は
-年・月・日などに分離された要素別の時刻を引き数とする。
+関数 \fBasctime\fP() と \fBmktime\fP() は 年・月・日などに分離された要素別の時刻を引き数とする。
.PP
-要素別の時刻は \fI<time.h>\fP で以下のように定義されている
-\fItm\fP 構造体に保持される。
+要素別の時刻は \fI<time.h>\fP で以下のように定義されている \fItm\fP 構造体に保持される。
.sp
.in +4n
.nf
.in
.PP
\fItm\fP 構造体のメンバーは以下の通り:
-.TP 10
-.I tm_sec
-秒数、ふつうは 0 から 59 までの値、
-しかし閏秒のため 60 までの値は許される。
-.TP
-.I tm_min
+.TP 10
+\fItm_sec\fP
+秒数、ふつうは 0 から 59 までの値、 しかし閏秒のため 60 までの値は許される。
+.TP
+\fItm_min\fP
分数、0 から 59 までの値。
-.TP
-.I tm_hour
+.TP
+\fItm_hour\fP
真夜中からの通算時間、0 から 23 までの値。
-.TP
-.I tm_mday
+.TP
+\fItm_mday\fP
月はじめからの日数、1 から 31 までの値。
-.TP
-.I tm_mon
+.TP
+\fItm_mon\fP
1月からの通算月数、0 から 11 までの値。
-.TP
-.I tm_year
+.TP
+\fItm_year\fP
1900 年からの通算年数。
-.TP
-.I tm_wday
+.TP
+\fItm_wday\fP
日曜日からの通算日数(曜日)。0 から 6 までの値。
-.TP
-.I tm_yday
+.TP
+\fItm_yday\fP
1 月 1 日からの通算日数、0 から 365 までの値。
-.TP
-.I tm_isdst
-夏時間が有効かどうかのフラグ。
-正の値ならば夏時間は有効になり、0 ならば無効、負の値ならばこの情報には
-意味がない。
+.TP
+\fItm_isdst\fP
+夏時間が有効かどうかのフラグ。 正の値ならば夏時間は有効になり、0 ならば無効、負の値ならばこの情報には 意味がない。
.PP
-.BI ctime( t )
-関数は、
-.BI asctime(localtime( t ))
-と等価である。
-カレンダー時刻 \fIt\fP を
+\fBctime(\fP\fIt\fP\fB)\fP 関数は、 \fBasctime(localtime(\fP\fIt\fP\fB))\fP と等価である。 カレンダー時刻 \fIt\fP を
.sp
.RS
-"Wed Jun 30 21:49:08 1993\\n"
+"Wed Jun 30 21:49:08 1993\en"
.RE
.sp
-という形式の NULL 終端された文字列へ変換する。
-曜日の略称は
-"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" である。
-月の略称は "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug",
-"Sep", "Oct", "Nov", "Dec" である。
-返り値は、静的 (static) に割り当てられた文字列へのポインタである。
-この文字列は、日付・時刻関数のいずれかが呼び出されると上書きされることがある。
-またこの関数は大域変数 \fItzname\fP, \fItimezone\fP, \fIdaylight\fP
-に現在のタイムゾーンの情報を設定する
-.RB ( tzset (3)
-参照)。
-リエントラント版である
-.BR ctime_r ()
-も同様だが、
-文字列はユーザーが用意したバッファに格納される。バッファのサイズは
-少なくとも 26 バイト以上でなければならない。
-この関数は \fItzname\fP, \fItimezone\fP, and \fIdaylight\fP
-を設定する必要はない。
+という形式の NULL 終端された文字列へ変換する。 曜日の略称は "Sun", "Mon", "Tue", "Wed", "Thu", "Fri",
+"Sat" である。 月の略称は "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug",
+"Sep", "Oct", "Nov", "Dec" である。 返り値は、静的 (static) に割り当てられた文字列へのポインタである。
+この文字列は、日付・時刻関数のいずれかが呼び出されると上書きされることがある。 またこの関数は大域変数 \fItzname\fP, \fItimezone\fP,
+\fIdaylight\fP に現在のタイムゾーンの情報を設定する (\fBtzset\fP(3) 参照)。 リエントラント版である \fBctime_r\fP()
+も同様だが、 文字列はユーザーが用意したバッファに格納される。バッファのサイズは 少なくとも 26 バイト以上でなければならない。 この関数は
+\fItzname\fP, \fItimezone\fP, and \fIdaylight\fP を設定する必要はない。
.PP
-関数
-.BR gmtime ()
-は、カレンダー時刻 \fItimep\fP を
-協定世界時 (UTC) での要素別の時刻へ変換する。
-年が整数型に収まらない場合、NULL を返す。
-返り値は静的に確保された構造体を指しており、この後で
-日付や時刻に関する関数のいずれかが呼び出されると
-上書きされる可能性がある。
-.BR gmtime_r ()
-も同様だが、
-データはユーザーが用意した構造体に格納される。
+関数 \fBgmtime\fP() は、カレンダー時刻 \fItimep\fP を 協定世界時 (UTC) での要素別の時刻へ変換する。
+年が整数型に収まらない場合、NULL を返す。 返り値は静的に確保された構造体を指しており、この後で 日付や時刻に関する関数のいずれかが呼び出されると
+上書きされる可能性がある。 \fBgmtime_r\fP() も同様だが、 データはユーザーが用意した構造体に格納される。
.PP
-関数
-.BR localtime ()
-は、カレンダー時刻 \fItimep\fP を
-ユーザが指定したタイムゾーンでの時刻要素別の表現へ変換する。
-この関数は
-.BR tzset (3)
-を呼び出したかのように振舞い、
-大域変数 \fItzname\fP に現在のタイムゾーンの情報を設定する。
-また、\fItimezone\fP に協定世界時 (UTC) とローカル標準時との
-時差の秒数を設定し、
-一年の一部で夏時間が適用される場合は \fIdaylight\fP に 0 が設定される。
-返り値は静的に確保された構造体を指しており、この後で
-日付や時刻に関する関数のいずれかが呼び出されると
-上書きされる可能性がある。
-.BR localtime_r ()
-も同様だが、
-データはユーザーが用意した構造体に格納される。
-この関数は \fItzname\fP, \fItimezone\fP, and \fIdaylight\fP
-を設定する必要はない。
+関数 \fBlocaltime\fP() は、カレンダー時刻 \fItimep\fP を ユーザが指定したタイムゾーンでの時刻要素別の表現へ変換する。 この関数は
+\fBtzset\fP(3) を呼び出したかのように振舞い、 大域変数 \fItzname\fP に現在のタイムゾーンの情報を設定する。
+また、\fItimezone\fP に協定世界時 (UTC) とローカル標準時との 時差の秒数を設定し、 一年の一部で夏時間が適用される場合は
+\fIdaylight\fP に 0 が設定される。 返り値は静的に確保された構造体を指しており、この後で 日付や時刻に関する関数のいずれかが呼び出されると
+上書きされる可能性がある。 \fBlocaltime_r\fP() も同様だが、 データはユーザーが用意した構造体に格納される。 この関数は
+\fItzname\fP, \fItimezone\fP, and \fIdaylight\fP を設定する必要はない。
.PP
-関数
-.BR asctime ()
-は、要素別の時刻 \fItm\fP を
-.BR ctime ()
-と同じ形式の NULL 終端された文字列へ変換する。
-返り値は静的に割り当てられた文字列へのポインタである。この文字列は、
-日付・時刻関数のいずれかが呼び出されると上書きされることがある。
-リエントラント版である
-.BR asctime_r ()
-も同様だが、
-文字列はユーザーが用意したバッファに格納される。バッファのサイズは
-少なくとも 26 バイト以上でなければならない。
+関数 \fBasctime\fP() は、要素別の時刻 \fItm\fP を \fBctime\fP() と同じ形式の NULL 終端された文字列へ変換する。
+返り値は静的に割り当てられた文字列へのポインタである。この文字列は、 日付・時刻関数のいずれかが呼び出されると上書きされることがある。
+リエントラント版である \fBasctime_r\fP() も同様だが、 文字列はユーザーが用意したバッファに格納される。バッファのサイズは 少なくとも
+26 バイト以上でなければならない。
.PP
-関数
-.BR mktime ()
-は、(ローカルタイムで記述されている) 要素別の時刻を
-カレンダー時刻へ変換する。この際、呼び出し元がフィールド
-.I tm_wday
-と
-.I tm_yday
-で指定した値は無視される。
-.BR mktime ()
-は、フィールド
-.I tm_isdst
-で指定された値により、
-.I tm
-構造体で渡された時刻で夏時間 (daylight saving time; DST) が有効になって
-いるかを知る。
-正の値は夏時間が有効であることを意味する。
-負の値であれば、
-.BR mktime ()
-は (タイムゾーン情報とシステムのデータベースを使って)
+関数 \fBmktime\fP() は、(ローカルタイムで記述されている) 要素別の時刻を カレンダー時刻へ変換する。この際、呼び出し元がフィールド
+\fItm_wday\fP と \fItm_yday\fP で指定した値は無視される。 \fBmktime\fP() は、フィールド \fItm_isdst\fP
+で指定された値により、 \fItm\fP 構造体で渡された時刻で夏時間 (daylight saving time; DST) が有効になって いるかを知る。
+正の値は夏時間が有効であることを意味する。 負の値であれば、 \fBmktime\fP() は (タイムゾーン情報とシステムのデータベースを使って)
指定された時刻で夏時間が有効かどうかを判断する必要があることを意味する。
-.BR mktime ()
-は
-.I tm
-構造体の各フィールドを以下のように修正する。
-.I tm_wday
-と
-.I tm_yday
-には他のフィールドの内容から求めた値を設定する。
-構造体の要素が有効な範囲にない場合、正規化される
-(例えば、10 月 40 日は 11 月 9 日に変更される)。
-.I tm_isdst
-には (最初の値にかかわらず) 正の値か 0 が設定される。
-正の値は指定された時間で夏時間が有効であることを示し、
-0 は無効であることを示す。
-関数
-.BR mktime ()
-を呼び出すと、
-大域変数 \fItzname\fP が現在のタイムゾーンに設定される。
+\fBmktime\fP() は \fItm\fP 構造体の各フィールドを以下のように修正する。 \fItm_wday\fP と \fItm_yday\fP
+には他のフィールドの内容から求めた値を設定する。 構造体の要素が有効な範囲にない場合、正規化される (例えば、10 月 40 日は 11 月 9
+日に変更される)。 \fItm_isdst\fP には (最初の値にかかわらず) 正の値か 0 が設定される。
+正の値は指定された時間で夏時間が有効であることを示し、 0 は無効であることを示す。 関数 \fBmktime\fP() を呼び出すと、 大域変数
+\fItzname\fP が現在のタイムゾーンに設定される。
-要素別の時刻をカレンダー時刻 (紀元 (Epoch) からの秒数) で表現できない場合、
-.BR mktime ()
-は
-.I (time_t)\ (-1)
-を返し、要素別の時刻の構造体メンバーを変更しない。
+要素別の時刻をカレンダー時刻 (紀元 (Epoch) からの秒数) で表現できない場合、 \fBmktime\fP() は \fI(time_t)\ (\-1)\fP を返し、要素別の時刻の構造体メンバーを変更しない。
.SH 返り値
-各関数はそれぞれ前述した値を返す。エラーの場合は NULL
-.RB ( mktime ()
-では \-1) を返す。
+各関数はそれぞれ前述した値を返す。エラーの場合は NULL (\fBmktime\fP() では \-1) を返す。
.SH 準拠
-POSIX.1-2001.
-C89 と C99 では
-.BR asctime (),
-.BR ctime (),
-.BR gmtime (),
-.BR localtime (),
-.BR mktime ()
-が規定されている。
-POSIX.1-2008 は、
-.BR asctime (),
-.BR asctime_r (),
-.BR ctime (),
-.BR ctime_r ()
-を廃止予定としている。
-代わりに、
-.BR strftime (3)
+POSIX.1\-2001. C89 と C99 では \fBasctime\fP(), \fBctime\fP(), \fBgmtime\fP(),
+\fBlocaltime\fP(), \fBmktime\fP() が規定されている。 POSIX.1\-2008 は、 \fBasctime\fP(),
+\fBasctime_r\fP(), \fBctime\fP(), \fBctime_r\fP() を廃止予定としている。 代わりに、 \fBstrftime\fP(3)
の使用が推奨されている。
.SH 注意
-.BR asctime (),
-.BR ctime (),
-.BR gmtime (),
-.BR localtime ()
-の 4 つの関数は静的データへのポインタを返すので、スレッドセーフではない。
-これらの関数のスレッドセーフ版である
-.BR asctime_r (),
-.BR ctime_r (),
-.BR gmtime_r (),
-.BR localtime_r ()
-は SUSv2 で規定されており、
-libc 5.2.5 以降で利用できる。
+\fBasctime\fP(), \fBctime\fP(), \fBgmtime\fP(), \fBlocaltime\fP() の 4
+つの関数は静的データへのポインタを返すので、スレッドセーフではない。 これらの関数のスレッドセーフ版である \fBasctime_r\fP(),
+\fBctime_r\fP(), \fBgmtime_r\fP(), \fBlocaltime_r\fP() は SUSv2 で規定されており、 libc 5.2.5
+以降で利用できる。
-POSIX.1-2001 では、「関数
-.BR asctime (),
-.BR ctime (),
-.BR gmtime (),
-.BR localtime ()
-は、要素別の時刻の構造体か
-.I char
-型の配列かのどちらかの静的オブジェクトを返すものとする。
-これらの関数のいずれかを実行すると、他の関数のどれかがこれらの
-静的オブジェクトのどちらかに格納して返した情報が上書きされるかも
-しれない。」となっている。
-このことは glibc の実装で起こりうる。
+POSIX.1\-2001 では、「関数 \fBasctime\fP(), \fBctime\fP(), \fBgmtime\fP(), \fBlocaltime\fP()
+は、要素別の時刻の構造体か \fIchar\fP 型の配列かのどちらかの静的オブジェクトを返すものとする。
+これらの関数のいずれかを実行すると、他の関数のどれかがこれらの 静的オブジェクトのどちらかに格納して返した情報が上書きされるかも
+しれない。」となっている。 このことは glibc の実装で起こりうる。
.LP
-glibc を含む多くの実装では、
-.I tm_mday
-に 0 を指定すると前月の最終日を意味していると解釈される。
+glibc を含む多くの実装では、 \fItm_mday\fP に 0 を指定すると前月の最終日を意味していると解釈される。
.LP
-glibc では、
-.I <time.h>
-がインクルードされる前に
-.B _BSD_SOURCE
-が定義されると、
-\fIstruct tm\fP に以下のフィールドが追加される。
+glibc では、 \fI<time.h>\fP がインクルードされる前に \fB_BSD_SOURCE\fP が定義されると、 \fIstruct
+tm\fP に以下のフィールドが追加される。
.sp
.RS
.nf
.fi
.RE
.sp
-これは BSD 拡張であり、4.3BSD-Reno から現れた。
+これは BSD 拡張であり、4.3BSD\-Reno から現れた。
-POSIX.1-2004 によると、
-.BR localtime ()
-はあたかも
-.BR tzset (3)
-が呼ばれたかのように振舞うことが要求されているが、
-.BR localtime_r ()
-にはこの要件はない。
-.\" http://thread.gmane.org/gmane.comp.time.tz/2034/ を参照。
-移植性が必要なコードでは、
-.BR localtime_r ()
-の前に
-.BR tzset (3)
-を呼び出しておくべきである。
+.\" See http://thread.gmane.org/gmane.comp.time.tz/2034/
+POSIX.1\-2004 によると、 \fBlocaltime\fP() はあたかも \fBtzset\fP(3)
+が呼ばれたかのように振舞うことが要求されているが、 \fBlocaltime_r\fP() にはこの要件はない。 移植性が必要なコードでは、
+\fBlocaltime_r\fP() の前に \fBtzset\fP(3) を呼び出しておくべきである。
.SH 関連項目
-.BR date (1),
-.BR gettimeofday (2),
-.BR time (2),
-.BR utime (2),
-.BR clock (3),
-.BR difftime (3),
-.BR strftime (3),
-.BR strptime (3),
-.BR timegm (3),
-.BR tzset (3),
-.BR time (7)
+\fBdate\fP(1), \fBgettimeofday\fP(2), \fBtime\fP(2), \fButime\fP(2), \fBclock\fP(3),
+\fBdifftime\fP(3), \fBstrftime\fP(3), \fBstrptime\fP(3), \fBtimegm\fP(3), \fBtzset\fP(3),
+\fBtime\fP(7)
OSDN Git Service
