[edit] Last updated: Fri, 17 May 2013

IntlDateFormatter::create

datefmt_create

IntlDateFormatter::__construct

(PHP 5 >= 5.3.0, PECL intl >= 1.0.0)

IntlDateFormatter::create -- datefmt_create -- IntlDateFormatter::__construct — Date Formatter を作成する

説明

オブジェクト指向型

static IntlDateFormatter IntlDateFormatter::create ( string $locale , int $datetype , int $timetype [, string $timezone [, int $calendar [, string $pattern ]]] )

オブジェクト指向型 (コンストラクタ)

IntlDateFormatter::__construct() ( string $locale , int $datetype , int $timetype [, string $timezone [, int $calendar [, string $pattern ]]] )

手続き型

IntlDateFormatter datefmt_create ( string $locale , int $datetype , int $timetype [, string $timezone [, int $calendar [, string $pattern ]]] )

Date Formatter を作成します。

パラメータ

locale: フォーマットやパースの際に使用するロケール。
datetype: 使用する日付の形式 (none, short, medium, long, full)。 IntlDateFormatter の定数のいずれかとなります。
timetype: 使用する時刻の形式 (none, short, medium, long, full)。 IntlDateFormatter の定数のいずれかとなります。
timezone: タイムゾーン ID。デフォルトはシステムの設定となります。
calendar: フォーマットやパースの際に使用するカレンダー。デフォルトは Gregorian (グレゴリオ暦) です。これは IntlDateFormatter のカレンダー定数のいずれかとなります。
pattern: フォーマットやパースの際に使用するオプションのパターン。使えるパターンについては » http://userguide.icu-project.org/formatparse/datetime を参照ください。

返り値

例

例1 datefmt_create() の例


<?php
$fmt = datefmt_create( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
    'America/Los_Angeles', IntlDateFormatter::GREGORIAN  );
echo "First Formatted output is ".datefmt_format( $fmt , 0);
$fmt = datefmt_create( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
    'America/Los_Angeles',IntlDateFormatter::GREGORIAN  );
echo "Second Formatted output is ".datefmt_format( $fmt , 0);

$fmt = datefmt_create( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
     'America/Los_Angeles',IntlDateFormatter::GREGORIAN  ,"MM/dd/yyyy");
echo "First Formatted output with pattern is ".datefmt_format( $fmt , 0);
$fmt = datefmt_create( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
     'America/Los_Angeles',IntlDateFormatter::GREGORIAN  ,"MM/dd/yyyy");
echo "Second Formatted output with pattern is ".datefmt_format( $fmt , 0);
?>

例2 オブジェクト指向の例


<?php
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
    'America/Los_Angeles',IntlDateFormatter::GREGORIAN  );
echo "First Formatted output is ".$fmt->format(0);
$fmt = new IntlDateFormatter( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL, 
    'America/Los_Angeles',IntlDateFormatter::GREGORIAN  );
echo "Second Formatted output is ".$fmt->format(0);

$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL, 
     'America/Los_Angeles',IntlDateFormatter::GREGORIAN  ,"MM/dd/yyyy");
echo "First Formatted output with pattern is ".$fmt->format(0);
$fmt = new IntlDateFormatter( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
      'America/Los_Angeles',IntlDateFormatter::GREGORIAN , "MM/dd/yyyy");
echo "Second Formatted output with pattern is ".$fmt->format(0);
?>

上の例の出力は以下となります。

First Formatted output is Wednesday, December 31, 1969 4:00:00 PM PT
Second Formatted output is Mittwoch, 31. Dezember 1969 16:00 Uhr GMT-08:00
First Formatted output with pattern is 12/31/1969
Second Formatted output with pattern is 12/31/1969

参考

datefmt_format() - 日付/時刻の値を文字列としてフォーマットする
datefmt_parse() - 文字列をパースしてタイムスタンプにする
datefmt_get_error_code() - 直近の操作のエラーコードを取得する
datefmt_get_error_message() - 直近の操作のエラーテキストを取得する

add a note User Contributed Notes IntlDateFormatter::create - [2 notes]

down

mikko dot rantalainen at peda dot net ¶

1 year ago


Documentation says "timezone: Time zone ID, default is system default."



The "system default" really means only the "TZ" environment variable on Unix/Linux systems. It does not mean PHP ini setting or value set via date_default_timezone_set() or the OS default time zone in file "/etc/timezone".

down

daniel dot rhodes at warpasylum dot co dot uk ¶

1 year ago


It should be noted that the locale string passed into IntlDateFormatter's constructor supports UCA keywords. So you can, for example, do things like this to output the year as a Japanese era year:





<?php


$now = new DateTime();    //DateTime is a core PHP class as of version 5.2.0





$formatter = new IntlDateFormatter('ja_JP', IntlDateFormatter::FULL,


        IntlDateFormatter::FULL, 'Asia/Tokyo', IntlDateFormatter::GREGORIAN);





echo 'It is now: "' . $formatter->format($now) . '" in Tokyo' . "\n";


//above gives [It is now: "2011年8月19日金曜日 23時32分27秒JST" in Tokyo]





$formatter = new IntlDateFormatter('ja_JP@calendar=japanese', IntlDateFormatter::FULL,


        IntlDateFormatter::FULL, 'Asia/Tokyo', IntlDateFormatter::TRADITIONAL);





echo 'It is now: "' . $formatter->format($now) . '" in Tokyo' . "\n";


//above gives [It is now: "平成23年8月19日金曜日 23時32分27秒JST" in Tokyo]


?>

add a note