.\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\"
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
.\"
.\" Modified, jmv@lucifer.dorms.spbu.ru, 1999-11-08
.\" Modified, aeb, 2000-04-07
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH STRPTIME 3 2009\-12\-05 GNU "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1998 SHOJI Yasushi all rights reserved.
+.\" Translated Fri Jun 26 1998 by SHOJI Yasushi <yashi@yashi.com>
+.\" Updated & Modefied Sun Mar 7 1999 by Shouichi Saito
+.\" Updated Tue Oct 10 22:29:13 JST 2000
+.\" by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
+.\" Updated Tue Apr 3 20:49:00 JST 2001
+.\" by Yuichi SATO <ysato@h4.dion.ne.jp>
+.\" Updated Thu Oct 11 10:05:36 JST 2001 by Yuichi SATO
+.\" Updated Fri Dec 14 16:34:23 JST 2001 by Yuichi SATO
+.\" Updated Sat Jan 5 22:17:34 JST 2002 by Yuichi SATO
+.\" Updated Wed Jan 14 23:21:57 JST 2002 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"
+.TH STRPTIME 3 2014\-01\-17 GNU "Linux Programmer's Manual"
.SH 名前
strptime \- 文字列であらわされている時間を tm 構造体の時間に変換する
.SH 書式
\fBchar *strptime(const char *\fP\fIs\fP\fB, const char *\fP\fIformat\fP\fB,\fP \fBstruct tm
*\fP\fItm\fP\fB);\fP
.SH 説明
-\fBstrptime\fP() 関数は \fBstrftime\fP(3) の逆関数であり、ポインタ \fIs\fP が指す文字列を時間に変換する。 変換の際には
-\fIformat\fP で指定したフォーマットを用い、値はポインタ \fItm\fP が指す \fItm\fP 構造体に収められる。 \fIformat\fP は、
-\fBscanf\fP(3) で使われているような、 フィールドディスクリプターとテキスト文字で構成されている文字列である。
+\fBstrptime\fP() 関数は \fBstrftime\fP(3) の逆関数である。 ポインタ \fIs\fP が指す文字列を \fIformat\fP
+で指定されたフォーマットを使って「要素別の時刻」に変換し、\fItm\fP が指す構造体に格納する。
+
+要素別の時刻構造体 \fItm\fP は \fI<time.h>\fP 内で以下の様に定義されている。
+.sp
+.in +4n
+.nf
+struct tm {
+ int tm_sec; /* 秒 (0\-60) */
+ int tm_min; /* 分 (0\-59) */
+ int tm_hour; /* 時間 (0\-23) */
+ int tm_mday; /* 月内の日付 (1\-31) */
+ int tm_mon; /* 月 (0\-11) */
+ int tm_year; /* 年 \- 1900 */
+ int tm_wday; /* 曜日 (0\-6, 日曜 = 0) */
+ int tm_yday; /* 年内通算日 (0\-365, 1 月 1 日 = 0) */
+ int tm_isdst; /* 夏時間 */
+};
+.fi
+.in
+
+\fItm\fP 構造体の詳細は \fBctime\fP(3) を参照。
+
+\fIformat\fP 引き数は、 \fBscanf\fP(3) で使われているような、 フィールドディスクリプターとテキスト文字で構成されている文字列である。
個々のフィールドディスクリプターは \fB%\fP とそれに続く文字からなり、 後者にフィールドディスクリプターを置き換える内容を指定する。
\fIformat\fP 文字列中の他の全ての文字には、入力文字列にマッチする文字がなければならない。 フォーマット文字列中にある空白は例外であり、
入力文字列中の 0 個以上の空白とマッチする。 2 つのフィールドディスクリプターの間には、 空白・英字・数字がなければならない。
日曜日を週の始まりとした年通算での週数 (0\-53)。 1 月の最初の日曜日を第 1 週目の最初の日する。
.TP
\fB%w\fP
-æ\97¥æ\9b\9cæ\97¥ã\82\92 0 ã\81¨ã\81\97ã\81\9fæ\95°å\97表è¨\98ã\81®æ\9b\9cæ\97¥ (0\-6)。
+æ\9b\9cæ\97¥ã\82\92表ã\81\99æ\95°å\97 (0\-6)ã\80\81æ\97¥æ\9b\9cæ\97¥ ã\81\8c 0。
.TP
\fB%W\fP
月曜日を週の始まりとした年通算での週数 (0\-53)。 1 月の最初の月曜日を第 1 週目の最初の日する。
\fB%Y\fP
年。世紀の部分を含む (例: 1991)。
.LP
-E や O という修正子を使うことで変更できるフィールドディスクリプタもある。 これらの修正子は、別のフォーマットや仕様を使うことを指示する。
+E や O という修飾子を使うことで変更できるフィールドディスクリプタもある。 これらの修飾子は、別のフォーマットや仕様を使うことを指示する。
別のフォーマットや仕様が現在のロケールに存在しないときは、 変更していないフィールドディスクリプタが使われる。
.LP
-E 修正子は、ロケールに依存した日付と時刻の別の表現形式が 入力文字列に含まれていることを指定する。
+E 修飾子は、ロケールに依存した日付と時刻の別の表現形式が 入力文字列に含まれていることを指定する。
.TP
\fB%Ec\fP
日付と時刻。ロケールに依存した別の表現形式を使う。
\fB%EY\fP
完全な形式の年。別の表現型式を使う。
.LP
-O 修正子は、ロケールに依存した別のフォーマットの中に 数値の入力があることを指定する。
+O 修飾子は、ロケールに依存した別のフォーマットの中に 数値の入力があることを指定する。
.TP
\fB%Od\fP または \fB%Oe\fP
月の初めからの通算の日付。ロケールに依存した別の数値シンボルを使う。 0 を頭につけてもよいが、必須ではない。
年の初めからの通算の週数 (日曜日を週の始めとする)。 ロケールに依存した別の数値シンボルを使う。
.TP
\fB%Ow\fP
-数値表記の曜日 (日曜日を 0 とする)。 ロケールに依存した別の数値シンボルを使う。
+曜日を表す数字 (日曜日 が 0)、
+ロケールに依存した別の数値シンボルを使う。
.TP
\fB%OW\fP
年の初めからの通算の週数 (月曜日を週の始めとする)。 ロケールに依存した別の数値シンボルを使う。
.TP
\fB%Oy\fP
年 (\fB%C\fP からのオフセット)。ロケールに依存した別の数値シンボルを使う。
-.LP
-要素別の時刻構造体 \fItm\fP は \fI<time.h>\fP 内で以下の様に定義されている。
-.sp
-.in +4n
-.nf
-struct tm {
- int tm_sec; /* 秒 */
- int tm_min; /* 分 */
- int tm_hour; /* 時間 */
- int tm_mday; /* 日 */
- int tm_mon; /* 月 */
- int tm_year; /* 年 */
- int tm_wday; /* 曜日 */
- int tm_yday; /* 年内通算日 */
- int tm_isdst; /* 夏時間 */
-};
-.fi
-.in
.SH 返り値
この関数の返り値は、関数の中で処理されなかった最初の文字へのポインタである。 フォーマット文字列が必要する以上の文字が入力文字列に含まれている場合、
返り値は最後に処理された入力文字の次の文字を指す。 すべての入力文字列が処理された場合、 返り値は文字列末尾の NULL バイトを指す。
この関数のプロトタイプを常に定義する。 glibc2 のインクルードファイルは、 \fB_XOPEN_SOURCE\fP または \fB_GNU_SOURCE\fP
が定義された場合のみ、 この関数のプロトタイプを提供する。
.PP
-libc 5.4.13 より前では、空白 (と \(aqn\(aq または \(aqt\(aq 指定) は扱われなかった。 ロケールの修正子
+libc 5.4.13 より前では、空白 (と \(aqn\(aq または \(aqt\(aq 指定) は扱われなかった。 ロケールの修飾子
\(aqE\(aq と \(aqO\(aq は受け付けられなかった。 また、\(aqC\(aq の指定は \(aqc\(aq
の指定と同じ意味で扱われた。
.PP
\(aqy\(aq (1 世紀中の年) の指定は、libc4 と libc5 では 20 世紀の年として解釈される。 glibc 2.0 では
1950\-2049 の範囲として解釈される。 glibc 2.1 からは 1969\-2068 の範囲として解釈される。
.SS "glibc での注意"
-対象性のために、glibc では \fBstrptime\fP() に \fBstrftime\fP(3) と同じフォーマット文字をサポートさせようとしている。
-多くの場合、対応するフィールドが解釈されるが、 \fItm\fP フィールドは変更されない。 使用可能なフォーマット文字を以下に示す。
+一貫性を持たせるため、glibc では \fBstrptime\fP() に \fBstrftime\fP(3)
+と同じフォーマット文字をサポートさせようとしている。多くの場合、対応するフィールドが解釈されるが、 \fItm\fP
+フィールドは変更されない。使用可能なフォーマット文字を以下に示す。
.TP
\fB%F\fP
\fB%Y\-%m\-%d\fP と同じ。ISO 8601 の日付形式。
.SH 関連項目
\fBtime\fP(2), \fBgetdate\fP(3), \fBscanf\fP(3), \fBsetlocale\fP(3), \fBstrftime\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。