小粋こいき空間くうかん  -  a cheap joke and a play on words site

WordPress における日付ひづけ／時間じかんの表示ひょうじとフォーマット変更へんこう方法ほうほう

WordPress への記事きじ投稿とうこう日びの日付ひづけおよび時間じかんの表示ひょうじ方法ほうほうと、日付ひづけ／時刻じこくフォーマットを変更へんこうするカスタマイズをご紹介しょうかいします。

このエントリーのきっかけは、当とうサイトで配布はいふしているテーマに表示ひょうじされる記事きじ投稿とうこう時間じかんを24時じ間あいだ表記ひょうきに変更へんこうする方法ほうほうについてのご質問しつもんだったのですが、それだけでは何なになので一いち通とおり調しらべてみました。

１．概要がいよう

テンプレートの記事きじ投稿とうこう時間じかんを表示ひょうじしたい位置いちに

<p><?php the_time() ?></p>

を設定せっていすると、下したのように時刻じこく情報じょうほうに変換へんかんされてページに表示ひょうじされます。

<p>21:07:51<p>

２．テンプレートタグ

日付ひづけ表示ひょうじ用ようテンプレートタグには次つぎの2つがあります。

２．１ the_time

記事きじの投稿とうこう時間じかんを表示ひょうじします。書式しょしきは次つぎの通とおりです。

<?php the_time('format') ?>

format には２項こう以降いこうに示しめす「表示ひょうじフォーマット」を設定せっていします。

カッコ内ないを省略しょうりゃくすると、４項こうの管理かんり画面がめんに設定せっていした表示ひょうじフォーマットが適用てきようされます。

２．２ the_date

記事きじの投稿とうこう時間じかんを表示ひょうじします。書式しょしきは次つぎの通とおりです。

<?php the_date('format', 'before', 'after', echo) ?>

the_time との違ちがいは、

• 同どう一いち日にちに複数ふくすう記事きじがある場合ばあいは最初さいしょの記事きじにだけ表示ひょうじ
• 日付ひづけ／時間じかんの前後ぜんごに表示ひょうじするテキストの指定していが可能かのう
• PHPの変数へんすうとして取得しゅとく可能かのう（その場合ばあい、表示ひょうじされません）

が挙あげられます。特とくに一ひとつ目めの振ふる舞まいが大おおきな違ちがいですので、使用しようする場所ばしょに応おうじて使つかい分わけると良よいでしょう。

format は３項こう以降いこうに示しめす「表示ひょうじフォーマット」を設定せっていします。before は日付ひづけ／時間じかんの前まえに表示ひょうじするテキスト、after は日付ひづけ／時間じかんの後のちに表示ひょうじするテキスト、echo は、日付ひづけ／時間じかんを表示ひょうじする場合ばあいは true、変数へんすうとして取得しゅとくする場合ばあいは false を設定せっていします。

変数へんすうとして取得しゅとくする場合ばあいのサンプルを以下いかに示しめします。

<?php $my_date = the_date('', '', '', false); ?>

カッコ内ないを全すべて省略しょうりゃくすると、４項こうの管理かんり画面がめんに設定せっていした表示ひょうじフォーマットが適用てきようされます。
管理かんり画面がめんに設定せっていした表示ひょうじフォーマットを適用てきようし、なおかつ日付ひづけ／時間じかんの前後ぜんごにテキスト（ここでは p 要素ようそをサンプルとして設定せってい）を表示ひょうじしたい場合ばあいは、次つぎのようにします。

<?php the_date('', '<p>', '</p>') ?>

このタグのパラメータに前後ぜんごのテキストが設定せっていできる理由りゆうは、仮かりにタグの外側そとがわに HTML タグを設定せっていした場合ばあい、（同どう一いち日にち付づけのエントリーが複数ふくすうあると）このタグが表示ひょうじされないことがあり、外側そとがわに設定せっていした HTML タグが残のこってしまいます。これを避さけるためにパラメータとしてタグを設定せっていできるようにしています。

３．表示ひょうじフォーマット

表示ひょうじフォーマットは、時間じかんを表示ひょうじするフォーマット文字もじ（後述こうじゅつ）と、任意にんいの文字もじ列れつで構成こうせいされます。
１項こうのように the_time を利用りようして

<p>21:07:51</p>

という表示ひょうじにしたい場合ばあいは、時分じぶん秒びょうのフォーマット文字もじ「h」「i」「s」と、それぞれを区切くぎる文字もじ「:」で、

<p><?php the_time('h:i:s') ?></p>

というフォーマットをパラメータに設定せっていします。

４．フォーマット設定せってい方法ほうほう

フォーマットは次つぎのいずれかの方法ほうほうで設定せっていすることができます。

• 管理かんり画面がめんの [オプション] - [一般いっぱん設定せってい] - [日付ひづけのフォーマット/時間じかんのフォーマット]
• テンプレートタグに直接ちょくせつ記述きじゅつ

「テンプレートタグに直接ちょくせつ記述きじゅつ」というのは、２．１項こうの例れいでは

<?php the_time('h:i:s') ?>

という風ふうに、カッコ内ないにパラメータとして表示ひょうじフォーマットを設定せっていすることを指さします。

管理かんり画面がめんでの設定せってい箇所かしょは下したのスクリーンショットの通とおりです。「日付ひづけのフォーマット：」フィールドの内容ないようが the_date、「時刻じこくのフォーマット：」フィールドの内容ないようが the_time に対応たいおうしています。

フィールドに設定せっていされたフォーマットを利用りようするには、２項こうに記しるした通とおり、テンプレートタグの the_date 、the_time のパラメータが空あきであることが条件じょうけんとなります。

当とうサイトで配布はいふしているテーマでは日付ひづけフォーマットを直接ちょくせつテンプレートに埋うめ込こんでますので、管理かんり画面がめんから設定せっていできるようにするには、テンプレートの下記かきの部分ぶぶんをそれぞれ変更へんこうしてください。

日付ひづけ表示ひょうじ（変更へんこう前まえ） *1

<?php the_date('Y.m.d', '<p class="date">', '</p>') ?>

日付ひづけ表示ひょうじ（変更へんこう後ご）

<?php the_date('', '<p class="date">', '</p>') ?>

時間じかん表示ひょうじ（変更へんこう前まえ）

Posted at <?php the_time('h:i') ?>

時間じかん表示ひょうじ（変更へんこう後ご）

Posted at <?php the_time() ?>

５．フォーマット文字もじ一覧いちらん

PHP：date より、よく使つかわれそうなフォーマット文字もじを抜粋ばっすいし、下記かきにまとめてみました。

なお、日本語にほんご版ばん WordPress の場合ばあい、表ひょう中ちゅうの月つき表示ひょうじおよび曜日ようび表示ひょうじは日本語にほんごになります（英語えいご表記ひょうきにする場合ばあいの変更へんこう方法ほうほうは「WordPress の月つき・曜日ようびを英語えいご表記ひょうきにする」を参照さんしょう）。

出力しゅつりょくされる日付ひづけ文字もじ列れつの書式しょしき

単位たんい	フォーマット文字もじ	意味いみ	表示ひょうじ例れい
年とし	Y	4桁けたの数字すうじ	1999, 2003
	y	2桁けたの数字すうじ	99, 03
月つき	m	2桁けたの数字すうじ	01 - 12
	n	1桁けたまたは2桁けたの数字すうじ	1 - 12
	F	フルスペル	January - December
	M	3文字もじの省略形しょうりゃくけい式しき	Jan - Dec
日ひ	d	2桁けたの数字すうじ	01 - 31
	j	1桁けたまたは2桁けたの数字すうじ	1 - 31
曜日ようび	D	3文字もじの省略形しょうりゃくけい式しき	Mon - Sun
	l	フルスペル	Sunday - Saturday
午前ごぜん/午後ごご	a	小文字こもんじ	am / pm
	A	大文字おおもじ	AM / PM
時とき	h	2桁けたの数字すうじ・12時じ間あいだ表示ひょうじ	01 - 12
	g	1桁けたまたは2桁けたの数字すうじ 12時じ間あいだ表示ひょうじ	1 - 12
	H	2桁けたの数字すうじ・24時じ間あいだ表示ひょうじ	00 - 23
	G	1桁けたまたは2桁けたの数字すうじ 24時じ間あいだ表示ひょうじ	0 - 23
分ぶん	i	先頭せんとうにゼロをつける	00 - 59
秒びょう	s	先頭せんとうにゼロをつける	00 - 59

以下いかは年月日ねんがっぴ・時じ分秒ふんびょうの設定せってい早見はやみ表ひょうです。

年月日ねんがっぴの設定せってい早見はやみ表ひょう

年とし		月つき		日ひ		設定せってい例れい	表示ひょうじ
4桁けた	Y	2桁けた	m	2桁けた	d	Y/m/d	2007/01/01
				0なし	j	Y/m/j	2007/01/1
		0なし	n	2桁けた	d	Y/n/d	2007/1/01
				0なし	j	Y/n/j	2007/1/1
2桁けた	y	2桁けた	m	2桁けた	d	y/m/d	07/01/01
				0なし	j	y/m/j	07/01/1
		0なし	n	2桁けた	d	y/n/d	07/1/01
				0なし	j	y/n/j	07/1/1

時分じぶん秒びょうの設定せってい早見はやみ表ひょう

時とき		分ぶん		秒びょう		設定せってい例れい	表示ひょうじ
12時じ間あいだ表記ひょうき・2桁けた	h	2桁けた	i	2桁けた	s	h:i:s	01:02:03
12時じ間あいだ表記ひょうき・0なし	g					g:i:s	1:02:03
24時じ間あいだ表記ひょうき・2桁けた	H					H:i:s	13:02:03(01:02:03)
24時じ間あいだ表記ひょうき・0なし	G					G:i:s	13:02:03(1:02:03)

６．参考さんこう・関連かんれんリンク

• WordPress Codex：Template Tags/the date

2007.03.13 追記ついき
テンプレート改修かいしゅうに伴ともない、４項こうの記述きじゅつを修正しゅうせいしました。

---

*1：2007.03.13 以前いぜんにテンプレートをダウンロードされた場合ばあい、メインページ／アーカイブページについては下記かきの変更へんこうを行おこなってください。

日付ひづけ表示ひょうじ（変更へんこう前まえ）

<p class="date"><?php the_time('Y.m.d') ?></p>

日付ひづけ表示ひょうじ（変更へんこう後ご）

<p class="date"><?php the_date() ?></p>