PHP Date/Time関数 リファレンス
PHP Date/Timeについて
Date/Time関数を使用すると、PHPスクリプトが実行されているサーバーから日付と時間を取得できます。その後、Date/Time関数を使用して、さまざまな形式で日付と時間をフォーマットできます。
注: これらの関数はサーバーのロケール設定に依存します。これらの関数を使用する際には、夏時間や閏年を考慮することを忘れないでください。
インストール
PHPのDate/Time関数はデフォルトでPHPに組み込まれています。したがってDate/Time関数を使用するためのインストールは必要ありません。
実行時の設定
Date/Time関数の動作はphp.iniファイルの下記の情報の設定に影響されます。
| 名前 | 説明 | デフォルト | PHPバージョン |
|---|---|---|---|
date.timezone |
デフォルトのタイムゾーン（すべてのDate/Time関数で使用されます） | “” | PHP 5.1 |
date.default_latitude |
デフォルトの緯度（date_sunrise()とdate_sunset()で使用されます） |
“31.7667” | PHP 5.0 |
date.default_longitude |
デフォルトの経度（date_sunrise()とdate_sunset()で使用されます） |
“35.2333” | PHP 5.0 |
date.sunrise_zenith |
デフォルトの日の出の天頂（date_sunrise()とdate_sunset()で使用されます） |
“90.83” | PHP 5.0 |
date.sunset_zenith |
デフォルトの日没の天頂（date_sunrise()とdate_sunset()で使用されます） |
“90.83” | PHP 5.0 |
PHP Date/Time関数
| 関数 | 説明 |
|---|---|
checkdate() |
グレゴリオ暦の日付を検証します |
date_add() |
日付に日、月、年、時間、分、秒を追加します |
date_create_from_format() |
指定された形式に従ってフォーマットされた新しいDateTimeオブジェクトを返します |
date_create() |
新しいDateTimeオブジェクトを返します |
date_date_set() |
新しい日付を設定します |
date_default_timezone_get() |
すべてのDate/Time関数で使用されるデフォルトのタイムゾーンを返します |
date_default_timezone_set() |
すべてのDate/Time関数で使用されるデフォルトのタイムゾーンを設定します |
date_diff() |
2つの日付の差を返します |
date_format() |
指定された形式に従ってフォーマットされた日付を返します |
date_get_last_errors() |
日付文字列で見つかった警告/エラーを返します |
date_interval_create_from_date_string() |
文字列の相対部分からDateIntervalを設定します |
date_interval_format() |
インターバルをフォーマットします |
date_isodate_set() |
ISO日付を設定します |
date_modify() |
タイムスタンプを変更します |
date_offset_get() |
タイムゾーンオフセットを返します |
date_parse_from_format() |
指定された形式に従って指定された日付の詳細情報を含む連想配列を返します |
date_parse() |
指定された日付の詳細情報を含む連想配列を返します |
date_sub() |
日付から日、月、年、時間、分、秒を差し引きます |
date_sun_info() |
指定された日と場所に対する日没/日の出と薄明の開始/終了に関する情報を含む配列を返します |
date_sunrise() |
指定された日と場所に対する日の出の時間を返します |
date_sunset() |
指定された日と場所に対する日没の時間を返します |
date_time_set() |
時間を設定します |
date_timestamp_get() |
Unixタイムスタンプを返します |
date_timestamp_set() |
Unixタイムスタンプに基づいて日付と時間を設定します |
date_timezone_get() |
指定されたDateTimeオブジェクトのタイムゾーンを返します |
date_timezone_set() |
DateTimeオブジェクトのタイムゾーンを設定します |
date() |
ローカルの日付と時間をフォーマットします |
getdate() |
タイムスタンプまたは現在のローカルの日付/時間の情報を返します |
gettimeofday() |
現在の時間を返します |
gmdate() |
GMT/UTCの日付と時間をフォーマットします |
gmmktime() |
GMTの日付に対するUnixタイムスタンプを返します |
gmstrftime() |
ロケール設定に従ってGMT/UTCの日付と時間をフォーマットします |
idate() |
ローカルの時間/日付を整数としてフォーマットします |
localtime() |
ローカル時間を返します |
microtime() |
マイクロ秒を含む現在のUnixタイムスタンプを返します |
mktime() |
日付に対するUnixタイムスタンプを返します |
strftime() |
ロケール設定に従ってローカルの時間および/または日付をフォーマットします |
strptime() |
strftime()で生成された時間/日付を解析します |
strtotime() |
英語のテキスト形式の日付/時間をUnixタイムスタンプに解析します |
time() |
現在の時間をUnixタイムスタンプとして返します |
timezone_abbreviations_list() |
dst、オフセット、およびタイムゾーン名を含む連想配列を返します |
timezone_identifiers_list() |
すべてのタイムゾーン識別子を含むインデックス配列を返します |
timezone_location_get() |
指定されたタイムゾーンの場所情報を返します |
timezone_name_from_abbr() |
略語からタイムゾーン名を返します |
timezone_name_get() |
タイムゾーンの名前を返します |
timezone_offset_get() |
GMTからのタイムゾーンオフセットを返します |
timezone_open() |
新しいDateTimeZoneオブジェクトを作成します |
timezone_transitions_get() |
タイムゾーンのすべての遷移を返します |
timezone_version_get() |
タイムゾーンデータベースのバージョンを返します |
PHPに事前定義されたDate/Time定数
| 定数 | 説明 |
|---|---|
DATE_ATOM |
Atom (例: 2019-01-18T14:13:03+00:00) |
DATE_COOKIE |
HTTP Cookies (例: Fri, 18 Jan 2019 14:13:03 UTC) |
DATE_ISO8601 |
ISO-8601 (例: 2019-01-18T14:13:03+0000) |
DATE_RFC822 |
RFC 822 (例: Fri, 18 Jan 2019 14:13:03 +0000) |
DATE_RFC850 |
RFC 850 (例: Friday, 18-Jan-19 14:13:03 UTC) |
DATE_RFC1036 |
RFC 1036 (例: Friday, 18-Jan-19 14:13:03 +0000) |
DATE_RFC1123 |
RFC 1123 (例: Fri, 18 Jan 2019 14:13:03 +0000) |
DATE_RFC2822 |
RFC 2822 (例: Fri, 18 Jan 2019 14:13:03 +0000) |
DATE_RFC3339 |
DATE_ATOMと同じ (PHP 5.1.3以降) |
DATE_RFC3339_EXTENDED |
RFC3339 拡張形式 (PHP 7.0.0以降) (例: 2019-01-18T16:34:01.000+00:00) |
DATE_RSS |
RSS (例: Fri, 18 Jan 2019 14:13:03 +0000) |
DATE_W3C |
World Wide Web Consortium (例: 2019-01-18T14:13:03+00:00) |
SUNFUNCS_RET_TIMESTAMP |
タイムスタンプ (PHP 5.1.2以降) |
SUNFUNCS_RET_STRING |
時:分 (例: 09:41) (PHP 5.1.2以降) |
SUNFUNCS_RET_DOUBLE |
浮動小数点数としての時間 (例: 9.75) (PHP 5.1.2以降) |