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 形 式 で の 年 の 始 め か ら の 週 番 号 (「 注 意 」 の 節 を 参 照 )。 10 進 数 表 記 で 、 01 か ら 53 の 値 と な る 。 週 番 号 は 、 新 し い 年 が 少 な く と も 4 日 以 上 含 ま れ る 最 初 の 週 を 1 と し て 計 算 す る 。 %U と %W も 参 照 の こ と 。 (SU)

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

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

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

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

+hhmm や −hhmm の 形 式 の タ イ ム ゾ ー ン (UTC へ の オ フ セ ッ ト 時 間 )。 (SU)

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) も 参 照 す る こ と 。

返 り 値

終 端 の ヌ ル バ イ ト を 含 め た 結 果 の 文 字 列 の 長 さ が max バ イ ト を 超 え な か っ た 場 合 、 strftime() 関 数 は 配 列 s に 格 納 さ れ た バ イ ト 数 を 返 す (こ の バ イ ト 数 に 終 端 の ヌ ル バ イ ト は 含 ま れ な い )。 終 端 の ヌ ル バ イ ト を 含 め た 結 果 の 文 字 列 の 長 さ が max バ イ ト を 超 え る 場 合 に は 、 strftime() は 0 を 返 し 、 配 列 の 内 容 は 不 定 と な る 。 返 り 値 0 は 必 ず し も エ ラ ー を 意 味 し て い る 訳 で は な い の で 注 意 す る こ と 。 例 え ば 、 多 く の ロ ケ ー ル で は %p は 空 文 字 列 を 返 す 。 同 様 に 、 空 の format 文 字 列 は 空 文 字 列 を 返 す 。

環 境 変 数

環 境 変 数 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つ 入 る 可 能 性 が 理 論 的 に は あ る こ と を 考 慮 し て の も の で あ る (実 際 に は 、 こ の よ う な 状 況 は こ れ ま で 一 度 も 起 こ っ て い な い )。

注 意

ISO 8601 の 週 ・ 曜 日 表 記 (Week Dates)
%G, %g, %V は 、 ISO 8601 標 準 に よ り 定 義 さ れ た 週 単 位 表 記 の 年 に よ り 計 算 さ れ る 値 を 出 力 す る 。 ISO 8601 標 準 の 週 単 位 表 記 で は 、 週 は 月 曜 日 か ら 開 始 さ れ 、 週 番 号 は 、 年 の 最 初 の 週 が 01 と な り 、 最 後 の 週 は 52 か 53 と な る 。 週 01 は 、 新 し い 年 が 4 日 以 上 含 ま れ る 最 初 の 週 で あ る 。 言 い 換 え る と 、 週 01 は 、 そ の 年 の 木 曜 日 を 含 む 最 初 の 週 、 つ ま り 1 月 4 日 を 含 む 週 と い う こ と で あ る 。 新 し い 年 の カ レ ン ダ ー 上 の 最 初 の 週 に 新 し い 年 が 3 日 以 下 し か 含 ま れ な い 場 合 、 ISO 8601 の 週 単 位 表 記 で は 、 こ れ ら の 日 を 前 の 年 の 週 53 の 一 部 と み な す 。 例 え ば 、 2010 年 1 月 1 日 は 金 曜 日 で あ り 、 そ の 週 に は 2010 年 の 日 が 3 日 し か 含 ま れ な い 。 し た が っ て 、 ISO 8601 の 週 単 位 表 記 で は 、 こ れ ら の 日 は 2009 年 (%G) の 週 53 (%V) の 一 部 と な る 。 ISO 8601 の 2010 年 の 週 01 は 2010 年 1 月 4 日 の 月 曜 日 か ら 始 ま る 。

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