• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

日付と時刻の書式

提供: WordPress Codex 日本語版
移動先: 案内検索

日付と時刻の書式をカスタマイズする

WordPress の関数の中には、the_date()the_time() などのように投稿日時を表示させるものがあります。こういった関数の中にはフォーマット文字列という、日時の表示方法を決める引数を使うことが出来ます。フォーマット文字列は日付関係の色々なパーツを組み合わせることが出来ます。

例えば、

<?php the_date("Y年n月j日 l"); ?>

とテンプレートの中に書くと、

2008年4月1日 火曜日

のように表示されます。

以下は、引数として使われているアルファベットの説明です。

  • l = 曜日(小文字の L)
  • n = 月。
  • j = 日にち。
  • S = 英語で日にちにつける接尾辞 (1st, 2nd, 15thst, nd, th)
  • Y = 4桁の年(小文字の y を使うと2桁になる)

WordPress は PHP というプログラミング言語で書かれているため、日付のフォーマットには PHP に組み込まれている日付関数を使用しています。PHP マニュアルの date(日付・時刻)関数の引数はそのまま WordPress にも用いることが出来ます。以下は、同ページにある便利な項目を表にしたものです。

     
d 日。先頭にゼロをつける。 01 から 31
j 日。先頭にゼロをつけない。 1 から 31
S 英語形式の序数を表す2文字のサフィックス。
jと一緒に使用できる。
1stや 2nd , 3rd , 15thなどに含まれる、st, nd, rd または th。
曜日
l フルスペル形式。(小文字の 'L') Sunday から Saturday
D 3文字のテキスト形式。 Mon から Sun
m 数字。先頭にゼロをつける。 01 から 12
n 数字。先頭にゼロをつけない。 1 から 12
F フルスペルの文字。 January から December
M 3文字形式。 Jan から Dec
Y 4桁の数字。 例: 1999 または 2003
y 2桁の数字。 例: 99 または 03
時刻
a 午前または午後(小文字) am または pm
A 午前または午後(大文字) AM または PM
g 時。12時間単位。先頭にゼロを付けない。 1 から 12
h 時。12時間単位。先頭にゼロをつける。 01 から 12
G 時。24時間単位。先頭にゼロを付けない。 0 から 23
H 時。24時間単位。先頭にゼロをつける。 00 から 23
i 分。先頭にゼロをつける。 00 から 59
s 秒。先頭にゼロをつける。 00 から 59
T タイムゾーンの略称 例: EST, MDT ...
全ての日付/時刻
c ISO 8601 2004-02-12T15:19:21+00:00
r RFC 2822 Thu, 21 Dec 2000 16:01:07 +0200


日付と時刻のフォーマットと、出力結果を例示します。

  • F j, Y g:i a - November 6, 2010 12:50 am
  • F j, Y - November 6, 2010
  • F, Y - November, 2010
  • g:i a - 12:50 am
  • g:i:s a - 12:50:48 am
  • l, F jS, Y - Saturday, November 6th, 2010
  • M j, Y @ G:i - Nov 6, 2010 @ 0:50
  • Y/m/d \a\t g:i A - 2010/11/06 at 12:50 AM
  • Y/m/d \a\t g:ia - 2010/11/06 at 12:50am
  • Y/m/d g:i:s A - 2010/11/06 12:50:48 AM
  • Y/m/d - 2010/11/06

以下のテンプレートファイル内の the_time() の記述は、

 This entry was posted on <?php the_time('l, F jS, Y') ?> and is filed under <?php the_category(', ') ?>.

Webサイト上では以下のように表示されるでしょう。

 This entry was posted on Friday, September 24th, 2004 and is filed under WordPress and WordPress Tips. 

(例は日本語にしたほうがいいかも。--Mizuno 2009年2月16日 (月) 07:54 (UTC))


ローカライズ

日付をローカライズするには、date_i18n()/en 関数を使ってください。

__() や _e() などを使えば日付フォーマット文字列を安全にローカライズすることができるでしょう。functions (demonstrated with get_the_date(__(…))):


エスケープ

\(文字) という書式を使って、お好みの文字をエスケープすることができます。例えば、\a\t とすると at というテキストをエスケープします。

最新英語版: WordPress Codex » Formatting Date and Time最新版との差分