パラメータ

format

次の変換指定子が format パラメータ用の文字列として認識されます

format	説明	戻り値の例
日	---	---
%a	短縮された曜日の名前	Sun から Sat
%A	完全な曜日の名前	Sunday から Saturday
%d	10 進数で 2 桁の日付 (先頭のゼロつき)	01 から 31
%e	1 桁の場合は先頭にスペースをいれた日付。 Windows ではそのようには実装されていません。詳細は以下を参照ください。	1 から 31
%j	3 桁で先頭にゼロを含む年間での日付	001 から 366
%u	ISO-8601 数値表現であらわした曜日	1 (月曜日) から 7 (日曜日)
%w	数値表現であらわした曜日	0 (日曜日) から 6 (土曜日)
週	---	---
%U	指定した年の週番号。最初の日曜日を第一週の開始日とする	13 (年間の第 13 週の場合)
%V	ISO-8601:1988 で規定された、指定した年の週番号。 週の開始日は月曜日で、第 1 週は少なくとも 4 日はあることになる	01 から 53 (53 は年をまたがる週になります)
%W	その年の週番号の数値表現。最初の月曜日を最初の週の初日とする	46 (46 番目の週の場合。開始日は月曜日)
月	---	---
%b	現在のロケールに基づく短縮された月の名前	Jan から Dec
%B	現在のロケールに基づく完全な月の名前	January から December
%h	現在のロケールに基づく短縮された月の名前 (%b のエイリアス)	Jan から Dec
%m	2 桁であらわした月	01 (1 月) から 12 (12 月)
年	---	---
%C	2 桁であらわした世紀 (年を 100 で割り、整数に丸めたもの)	20 正規の場合は 19
%g	2 桁であらわした年。ISO-8601:1988 標準形式 (%V を参照)	2009 年 1 月 6 日の場合は 09
%G	%g の 4 桁完全版	2009 年 1 月 3 日の場合は 2009
%y	2 桁であらわした年	2009 年の場合は 09、1979 年の場合は 79
%Y	4 桁であらわした年	2038
時	---	---
%H	2 桁であらわした 24 時間制の時間	00 から 23
%k	24 時間制の時間で、1 桁の場合は先頭にスペースをつけたもの	0 から 23
%I	2 桁であらわした 12 時間制の時間	01 から 12
%l (小文字の 'L')	12 時間制の時間で、1 桁の場合は先頭にスペースをつけたもの	1 から 12
%M	2 桁であらわした分	00 から 59
%p	指定した時刻に応じた大文字の 'AM' あるいは 'PM'	00:31 なら AM、22:23 なら PM。 正確な結果はオペレーティングシステムに依存します。 (a.m. のような) 小文字やドット付きの結果を返すこともあります。
%P	指定した時刻に応じた小文字の 'am' あるいは 'pm'	00:31 なら am、22:23 なら pm。 全てのオペレーティングシステムでサポートされているとは限りません。
%r	"%I:%M:%S %p" と同じ	21:34:17 なら 09:34:17 PM
%R	"%H:%M" と同じ	12:35 AM なら 00:35、4:44 PM なら 16:44
%S	2 桁であらわした秒	00 から 59
%T	"%H:%M:%S" と同じ	09:34:17 PM なら 21:34:17
%X	ロケールに基づいた時刻の表現。日付は含まない	03:59:16 あるいは 15:59:16
%z	タイムゾーンオフセット。Windows では違う実装になっています。詳細は後述します。	東海岸時刻なら -0500
%Z	タイムゾーンの略称。Windows では違う実装になっています。詳細は後述します。	東海岸時刻なら EST
タイムスタンプ	---	---
%c	現在のロケールにもとづく日付と時間の表現	2009 年 2 月 5 日 午前 12:45:10 なら Tue Feb 5 00:45:10 2009
%D	"%m/%d/%y" と同じ	2009 年 2 月 5 日なら 02/05/09
%F	"%Y-%m-%d" と同じ (データベースのタイムスタンプとして一般的)	2009 年 2 月 5 日なら 2009-02-05
%s	Unix エポックからのタイムスタンプ (time() 関数と同じ)	1979 年 9 月 10 日午前 08:40:00 なら 305815200
%x	現在のロケールにもとづく日付の表現 (時間は除く)	2009 年 2 月 5 日なら 02/05/09
その他	---	---
%n	改行文字 ("\n")	---
%t	タブ文字 ("\t")	---
%%	パーセント文字 ("%")	---

警告

ISO-9889:1999 に反して、Sun Solaris は日曜日を 1 としています。 そのため、%u はこのマニュアルの説明どおりに機能しないかもしれません。

警告

Windows 限定:

Windows 上では %e に対応していません。 この値が欲しければ、代わりに %#d を使いましょう。 クロスプラットフォーム対応の関数を書く方法をこの後の例で示します。

%z と %Z は、どちらもタイムゾーン名を返します。オフセットや略称は返しません。

警告

macOS と musl 限定: %P 修飾子は macOS 版の実装ではサポートされていません。

timestamp

オプションのパラメータ timestamp は、 int 型の Unix タイムスタンプです。 timestamp が指定されなかったり、null だった場合のデフォルト値は、 現在の時刻です。言い換えると、デフォルトは time() の返り値となります。