Pot.DateTime.format

指定されたタイムスタンプを表す引数 timestamp を、
引数のフォーマット文字列 dateFormat により書式化し、日付文字列を返します。
引数 timestamp が与えられると、timestamp の日時で返します。
timestamp が省略されると 現在の時刻が使用されます。

この関数は、PHP の date() 関数 とほぼ同じに動作します。
以下の表は引用も含まれています。以下の文字が dateFormat パラメータ文字列として認識されます。

dateFormat 文字	説明	戻り値の例
日	---	---
d	日。二桁の数字 (先頭にゼロがつく場合も)	01 から 31
D	曜日。3 文字のテキスト形式。	Mon から Sun
j	日。先頭にゼロをつけない。	1 から 31
l (小文字の 'L')	曜日。フルスペル形式。	Sunday から Saturday
N	ISO-8601 形式の、曜日の数値表現	1 (月曜日) から 7 (日曜日)
S	英語形式の序数を表すサフィックス。2 文字。	st, nd, rd または th など。 j と一緒に使用することができる。
w	曜日。数値。	0 (日曜)から 6 (土曜)
J	曜日。日本の曜日。文字列。	日 (日曜) から 土 (土曜)
z	年間の通算日。数字。(0 から開始)	0 から 365
月	---	---
F	月。フルスペルの文字。	January から December
m	月。数字。先頭にゼロをつける。	01 から 12
M	月。3 文字形式。	Jan から Dec
n	月。数字。先頭にゼロをつけない。	1 から 12
o	月。文字列。日本の旧月名。	霜月, 水無月 など
t	指定した月の日数。	28 から 31
年	---	---
L	閏年かどうか。	1 なら閏年。0 なら閏年でない。
Y	年。4 桁の数字。	例: 1999, 2003 など
y	年。2 桁の数字。	例: 99, 03 など
時	---	---
a	午前または午後 (小文字)	am または pm
A	午前または午後 (大文字)	AM または PM
g	時。12時間単位。先頭にゼロを付けない。	1 から 12
G	時。24時間単位。先頭にゼロを付けない。	0 から 23
h	時。数字。12 時間単位。	01 から 12
H	時。数字。24 時間単位。	00 から 23
i	分。先頭にゼロをつける。	00 から 59
s	秒。先頭にゼロをつける。	00 から 59
u	マイクロ秒。(0 でパディングして桁合わせするだけ)	例: 654000 など
タイムゾーン	---	---
O	グリニッジ標準時 (GMT) との時差	例: +0900
P	グリニッジ標準時 (GMT) との時差。時間と分をコロンで区切った形式。	例: +09:00
T	タイムゾーンの略称	例: EST, MDT ...
Z	タイムゾーンのオフセット秒数。 UTC の西側のタイムゾーン用のオフセットは常に負です。 そして、UTC の東側のオフセットは常に正です。	-43200 から 50400
全ての日付/時刻	---	---
c	ISO 8601 日付	例: 2004-02-12T15:19:21+00:00
r	≫ RFC 2822 フォーマットされた日付	例: Thu, 21 Dec 2000 16:01:07 +0200
U	Unix Epoch (1970 年 1 月 1 日 0 時 0 分 0 秒) からの秒数	Pot.time() も参照

フォーマット文字は、バックスラッシュ \ によってエスケープすることができます。

var result = Pot.date('Y/m/d (J) H:i [\\o=o]');

debug(result); // e.g. '2011/06/08 (水) 11:30 [o=水無月]'

また、以下の定義済みの定数が用意されています。以下のように使用できます。

debug( Pot.date.RSS );           // 'D, d M Y H:i:s O'
debug( Pot.date(Pot.date.RSS) ); // e.g. 'Mon, 15 Aug 2005 15:52:01 +0000'

定義済み定数:

Pot.DateTime.format() は、Pot.date() としてアクセスできます。
Pot.globalize() が適応されている場合、Pot.date() が date() で実行できます。

書式化した日時が文字列で返ります。

debug( Pot.date('Y-m-d H:i:s') );           // e.g. '2011-06-07 01:25:17'
debug( Pot.date('Y/m/d (J) H:i [\\o=o]') ); // e.g. '2011/06/08 (水) 11:30 [o=水無月]'
debug( Pot.date(Pot.date.RFC2822);          // e.g. 'Wed, 08 Jun 2011 02:34:21 +0900'