Manpages

%E

%j

%m

%n 改 行

%O 別 形 式 を

%p 現 在 の ロ ケ ー ル に お け る 「 午 前 」 「 午 後 」 に

%r

%s

%t タ ブ 文 字

(SU)

%T

%u 週 の 何 番 目 の 日

(10 進 数 表 記 ) か 。 月 曜 日 を 1 と す る (1-7)。 %w も

%U 年 の 初 め か ら の 通 算 の 週 数

(10 進 数 表 記 ) (00-53)。 そ の 年 の 最 初 の

%V

ISO 8601:1988 形 式 で の 年 の 始 め か ら の 週 数 (10 進 数 表 記 ) (00-53)。 そ の 年 に 少 な く と も 4 日 以 上 含 ま れ る 最 初 の 週 を 1 と し て 計 算 す る 。 週 の 始 ま り は 月 曜 日 と す る 。 %U と %W も 参 照 す る こ と 。

週 の 何 番 目 の 日 (10 進 数 表 記 ) か 。 日 曜 日 を 0 と す る 。 (0-6)。 %u も 参 照 。 (SU)

年 の 初 め か ら の 通 算 の 週 数 (10 進 数 表 記 ) (00-53)。 そ の 年 の 最 初 の 月 曜 日 を 、 第 1 週 の 始 ま り と し て 計 算 す る 。
%x

現 在 の ロ ケ ー ル で 一 般 的 な 日 付 表 記 。 時 刻 は 含 ま な い 。

2桁 (世 紀 部 分 を 含 ま な い 年 ) (00-99)。

で あ る 。 ("%a, %d %b %Y %H:%M:%S %z" と し て 使 用 す る )。 (GNU)

date(1) 形 式 で の 日 時 。 (TZ) (glibc2 で は サ ポ ー ト さ れ て い な い )

い く つ か の 変 換 指 定 で は 、 変 換 指 定 文 字 の 前 に E や O 「 修 飾 子 」 を 置 く こ と に よ っ て 別 書 式 を 使 用 す る よ う に 指 定 す る こ と が で き る 。 現 在 の ロ ケ ー ル に お い て 別 書 式 が 存 在 し な い 場 合 に は 、 通 常 の 変 換 指 定 が 使 用 さ れ た か の よ う に 動 作 す る (SU)。 統 一 UNIX 規 格 (Single Unix Specification) で は %Ec, %EC, %Ex, %EX, %Ey, %EY, %Od, %Oe, %OH, %OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow, %OW, %Oy, に つ い て 記 述 が あ る 。 こ こ で O 修 飾 子 は 別 形 式 の 数 値 (ロ ー マ 数 字 と か ) を 指 定 す る た め に 使 用 す る 。 E 修 飾 子 は ロ ケ ー ル 依 存 の 別 表 現 を 指 定 す る の に 使 用 す る 。 (訳 注 : E 修 飾 子 は 日 本 で 使 用 さ れ て い る 「 昭 和 」 「 平 成 」 な ど の 元 号 に よ る 年 表 記 を 指 定 す る 。 glibc 2.2 以 降 で の み 有 効 ) 要 素 別 の 時 刻 構 造 体 tm の 詳 細 は <time.h> に 定 義 さ れ て い る 。 ctime(3) も 参 照 す る こ と 。

返 り 値

strftime() 関 数 は 文 字 列 s に 格 納 さ れ た 文 字 数 を 返 す 。 こ の 文 字 数 に 終 端 の NULL バ イ ト は 含 ま な い 。 終 端 の NULL バ イ ト を 格 納 で き る だ け の 大 き さ を 持 っ た 文 字 列 を 渡 す こ と 。 そ れ 以 外 の 場 合 は 0 を 返 し 、 文 字 列 の 内 容 は 修 正 さ れ な い 。 (libc 4.4.4 以 降 で こ の 挙 動 が 適 用 さ れ て い る 。 libc 4.4.1 な ど の 非 常 に 古 い バ ー ジ ョ ン の libc で は 文 字 列 が 短 か 過 ぎ た 場 合 に は max が 返 さ れ る 。 ) 返 り 値 0 は 必 ず し も エ ラ ー を 意 味 し て い る 訳 で は な い の で 注 意 す る こ と 。 例 え ば 、 多 く の ロ ケ ー ル で は %p は 空 文 字 列 を 返 す 。

環 境 変 数

環 境 変 数 TZ と LC_TIME が 使 用 さ れ る 。 (訳 注 : LC_ALL が 設 定 さ れ て い る 場 合 に は LC_TIME よ り も そ ち ら が 優 先 さ れ る 。 LC_TIME も LC_ALL も 設 定 さ れ て い な い 場 合 に は LANG が 使 用 さ れ る 。 )

準 拠

SVr4, C89, C99. 個 々 の 変 換 が 厳 密 に ど の 規 格 に 含 ま れ る か は 、 ANSI C (印 な し )、 統 一 UNIX 規 格 (SU印 )、 Olson の timezone パ ッ ケ ー ジ (TZ印 )、 glibc 独 自 (GNU印 ) で 示 し て い る 。 glibc2 で は %+ は サ ポ ー ト さ れ て い な い が 、 い く つ か の 拡 張 が 行 わ れ て い る 。 POSIX.1 で は ANSI C の み を 参 照 し て い る 。 POSIX.2 の date(1) の と こ ろ に 記 述 さ れ て い る 幾 つ か の 拡 張 は strftime() に も 適 用 で き る だ ろ う 。 %F 変 換 は C99 と POSIX.1-2001 に あ る 。

SUSv2 で は 、 %S は 00 か ら 61 の 範 囲 を と る と 規 定 さ れ て い る 。 こ れ は 、 1分 間 の う ち 閏 秒 が 2つ 入 る 可 能 性 が 理 論 的 に は あ る こ と を 考 慮 し て の も の で あ る (実 際 に は 、 こ の よ う な 状 況 は こ れ ま で 一 度 も 起 こ っ て い な い )。

注 意

glibc で の 注 意
glibc で は 変 換 指 定 に い く つ か 拡 張 を 行 っ て い る (こ れ ら の 拡 張 は POSIX.1-2001 に は 規 定 さ れ て い な い が 、 他 の い く つ か の シ ス テ ム で 同 様 の 機 能 が 提 供 さ れ て い る )。 '%' 文 字 と 変 換 指 定 文 字 の 間 に 、 オ プ シ ョ ン と し て flag と フ ィ ー ル ド の 幅 を 指 定 で き る (こ れ ら を 指 定 す る 場 合 に は E や O 修 飾 子 の 前 に 置 く )。 以 下 の フ ラ グ 文 字 が 使 用 で き る :