関数・クラス解説

idate

ローカルな時刻/日付を整数として整形する

公式リファレンス

書式

idate ( string $format [, int $timestamp = time() ] ) : int

説明

指定された引数 timestamp を、 与えられたフォーマット文字列によりフォーマットし、日付数値を返します。 タイムスタンプが与えられない場合は、現在のローカル時刻が使われます。 つまり、timestamp はオプションであり、 そのデフォルト値は time() の値です。

関数 date() と異なり、idate() は format パラメータ中は一文字しか受け取りません。

パラメータ

format

以下の文字が format パラメータ文字列として認識されます

format 文字	説明
B	Swatch ビート/インターネット時間
d	月の日
h	時 (12 時間単位)
H	時 (24 時間単位)
i	分
I (大文字の i)	夏時間の適用中は 1、 そうでなければ 0 を返す
L (大文字の l)	閏年なら 1、 そうでなければ 0 を返す
m	月数
s	秒
t	現在の月の日数
U	Unix Epoch (January 1 1970 00:00:00 UTC) からの秒数。 これは time() と同じです
w	曜日 (日曜日は 0)
W	ISO-8601 形式。月曜日から始まる年単位の週番号
y	年 (1 桁あるいは 2 桁の数値 - 下の「注意」を確認ください)
Y	年 (4 桁)
z	年間の通算日
Z	タイムゾーンのオフセット秒数

timestamp

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

返値

整数値を返します。 idate() が返す値の型は常に int であり、 先頭に "0" がくることはありません。そのため、idate() の返す結果が予想より少ない桁数になることもあります。以下の例を参照ください。

エラー

すべての日付/時刻関数は、有効なタイムゾーンが設定されていない場合に E_NOTICEを発生させます。また、システム設定のタイムゾーンあるいは環境変数TZ を使用した場合には E_STRICTあるいは E_WARNING を発生させます。date_default_timezone_set() も参照ください。

サンプル

例1 idate() の例
 

$timestamp = strtotime('1st January 2004'); //1072915200

// これは、年を 2 桁で表示します。
// しかし、ここでは年が "0" から始まるので、
// "4" だけが表示されます。
echo idate('y', $timestamp);

参考

ワード検索

関数名アルファベット別

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール