.\" Japanese Version Copyright (c) 2002 NAKANO Takeo
.\" and Copyright (c) 2008, Akihiro MOTOKI all rights reserved.
.\"
-.TH GETDATE 3 2014\-01\-17 "" "Linux Programmer's Manual"
+.TH GETDATE 3 2014\-06\-13 "" "Linux Programmer's Manual"
.SH 名前
getdate, getdate_r \- 日付と時刻の文字列を要素別の時刻に変換する
.SH 書式
.RE
.ad
.SH 説明
-\fBgetdate\fP() 関数は、 \fIstring\fP が指すバッファに格納された文字列表現の日付と時刻を、 要素別の時刻 (broken\-down
-time) に変換する。 要素別の時刻は \fItm\fP 構造体に格納され、この構造体へのポインタが関数の結果として返される。 この \fItm\fP
-構造体は静的なメモリ領域にあり、 \fBgetdate\fP() のそれ以降の呼び出しで上書きされるかもされない。
+\fBgetdate\fP() é\96¢æ\95°ã\81¯ã\80\81 \fIstring\fP ã\81\8cæ\8c\87ã\81\99ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\81\9fæ\96\87å\97å\88\97表ç\8f¾ã\81®æ\97¥ä»\98ã\81¨æ\99\82å\88»ã\82\92ã\80\81 è¦\81ç´ å\88¥ã\81®æ\99\82å\88» (broken\-down
+time) ã\81«å¤\89æ\8f\9bã\81\99ã\82\8bã\80\82 è¦\81ç´ å\88¥ã\81®æ\99\82å\88»ã\81¯ \fItm\fP æ§\8bé\80 ä½\93ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\80\81ã\81\93ã\81®æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81\8cé\96¢æ\95°ã\81®çµ\90æ\9e\9cã\81¨ã\81\97ã\81¦è¿\94ã\81\95ã\82\8cã\82\8bã\80\82 ã\81\93ã\81® \fItm\fP
+構造体は静的なメモリー領域にあり、 \fBgetdate\fP() のそれ以降の呼び出しで上書きされるかもされない。
(\fIformat\fP 引き数でフォーマットを指定する) \fBstrptime\fP(3) とは違い、 \fBgetdate\fP() は環境変数
\fBDATEMSK\fP で指定されたフルパス名のファイルに書いてあるフォーマットを用いる。
日付の指定がなかったが、時間 (hour) だけ指定された場合は、 現在の時間またはそれ以降で、その指定に合致する最初の時間が採用される。
\fBgetdate_r\fP() は GNU 拡張で \fBgetdate\fP() のリエントラント版を提供している。 \fBgetdate_r\fP()
-では、エラーを報告するのにグローバル変数を使用したり、 要素別の時刻を返すのに静的なバッファを使用したりせず、
-エラーを関数の返り値経由で報告し、要素別の時刻を 引き数 \fIres\fP が指し示す呼び出し側で割り当てたバッファに格納して返す。
+ã\81§ã\81¯ã\80\81ã\82¨ã\83©ã\83¼ã\82\92å ±å\91\8aã\81\99ã\82\8bã\81®ã\81«ã\82°ã\83ã\83¼ã\83\90ã\83«å¤\89æ\95°ã\82\92使ç\94¨ã\81\97ã\81\9fã\82\8aã\80\81 è¦\81ç´ å\88¥ã\81®æ\99\82å\88»ã\82\92è¿\94ã\81\99ã\81®ã\81«é\9d\99ç\9a\84ã\81ªã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82\92使ç\94¨ã\81\97ã\81\9fã\82\8aã\81\9bã\81\9aã\80\81
+ã\82¨ã\83©ã\83¼ã\82\92é\96¢æ\95°ã\81®è¿\94ã\82\8aå\80¤çµ\8cç\94±ã\81§å ±å\91\8aã\81\97ã\80\81è¦\81ç´ å\88¥ã\81®æ\99\82å\88»ã\82\92 å¼\95ã\81\8dæ\95° \fIres\fP ã\81\8cæ\8c\87ã\81\97示ã\81\99å\91¼ã\81³å\87ºã\81\97å\81´ã\81§å\89²ã\82\8aå½\93ã\81¦ã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«æ ¼ç´\8dã\81\97ã\81¦è¿\94ã\81\99ã\80\82
.SH 返り値
-成功すると、 \fBgetdate\fP() は \fIstruct tm\fP へのポインタを返す。 失敗すると NULL を返し、グローバル変数
+æ\88\90å\8a\9fã\81\99ã\82\8bã\81¨ã\80\81 \fBgetdate\fP() ã\81¯ \fIstruct tm\fP ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\80\82 失æ\95\97ã\81\99ã\82\8bã\81¨ NULL ã\82\92è¿\94ã\81\97ã\80\81ã\82°ã\83ã\83¼ã\83\90ã\83«å¤\89æ\95°
\fIgetdate_err\fP に以下に示すエラー番号のいずれか一つを設定する。 \fIerrno\fP の変更については規定されていない。
成功すると、 \fBgetdate_r\fP() は 0 を返す。 失敗すると、以下に示すエラー番号のいずれか一つを返す。
.TP
\fB6\fP
.\" Error 6 doesn't seem to occur in glibc
-ã\83¡ã\83¢ã\83ªã\81®å\89²ã\82\8aå½\93ã\81¦ã\81«å¤±æ\95\97ã\81\97ã\81\9f (ã\83¡ã\83¢ã\83ªが足りない)。
+ã\83¡ã\83¢ã\83ªã\83¼ã\81®å\89²ã\82\8aå½\93ã\81¦ã\81«å¤±æ\95\97ã\81\97ã\81\9f (ã\83¡ã\83¢ã\83ªã\83¼が足りない)。
.TP
\fB7\fP
入力にマッチしたファイルに、行が含まれていない。
\fBgetdate\fP() は \fBstrptime\fP(3) を用いて実装されており、 両者では全く同じ変換が両者でサポートされている。
.SH 例
以下のプログラムは、コマンドライン引き数のそれぞれについて \fBgetdate\fP() を呼び出し、それぞれについて返された \fItm\fP
-æ§\8bé\80 ä½\93ã\81®ã\83\95ã\82£ã\83¼ã\83«ã\83\89å\80¤ã\82\92表示ã\81\99ã\82\8bã\80\82 次ã\81®ã\82·ã\82§ã\83«ã\83»ã\82»ã\83\83ã\82·ã\83§ã\83³ã\81¯ã\80\81ã\83\97ã\83ã\82°ã\83©ã\83 ã\81®å\8b\95ä½\9cä¾\8bã\81§ã\81\82ã\82\8bã\80\82
+構造体のフィールド値を表示する。 次のシェルセッションは、プログラムの動作例である。
.in +4n
.nf
.SS プログラムのソース
\&
.nf
-#define _GNU_SOURCE 500
+#define _GNU_SOURCE
#include <time.h>
#include <stdio.h>
#include <stdlib.h>
.SH 関連項目
\fBtime\fP(2), \fBlocaltime\fP(3), \fBsetlocale\fP(3), \fBstrftime\fP(3), \fBstrptime\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.68 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。