getDate() メソッドは、地域化された書式の日付を含む文字列をパースします。 結果は構造化された配列で返されます。この配列のキーが、日付の各部分を表します。 さらに、この配列には 'date_format' というキーがあり、 入力日付文字列をパースする際に使用する書式文字列がここに含まれます。 地域化された日付文字列が日付/時刻のすべての要素を含んでいるとは限らないので、 配列のすべてのキーが存在するとは限りません。 たとえば年月日のみが指定された場合は、時刻に関する情報は配列から取り除かれます。 逆に時分秒のみが指定された場合も同様です。 入力に日付や時刻が含まれない場合は、例外がスローされます。

setOption('fix_date' => true) が設定されると、 getDate() メソッドは 'fixed' というキーを追加します。ここには数値が格納され、 入力の日付文字列の年月日の順序を入れ替えたりして 使用する書式にあわせるための情報を表します。

日付文字列の書式を明示的に指定したい場合のために、次のような書式トークン指定子をサポートしています。 Zend_Locale_Format のメソッドでユーザ定義書式に対応しているものの中で無効な書式指定子を使用した場合、 たとえば ISO モードで PHP の 'i' 指定子を使用した場合などには例外がスローされます。

これらの (以下の) 指定子は、Zend_Date の toString() がサポートしている完全な "ISO" セットの一部です。PHP の date() 関数と同じ形式の指定子を使用したい場合は、 まず最初に setOptions('format_type' => 'php') をコールしてください。 特定のひとつの書式文字列だけを PHP の date() 互換形式から "ISO" 形式に変換したい場合は convertPhpToIsoFormat() を使用します。現時点では、分の形式のみが異なっています (ISO のデフォルトでは 'm'、PHP の date 関数では 'i' を使用します)。

<?php
require_once 'Zend/Locale.php';

$dateString = Zend_Locale_Format::getDate('13.04.2006', array('date_format' => 'dd.MM.yyyy'));
$dateObject = Zend_Date('13.04.2006', array('date_format' => 'dd.MM.yyyy')); // この日付に対応する Zend_Date オブジェクトを作成します

print_r($dateString); // 出力は、このようになります

Array
(
    [format] => dd.MM.yyyy
    [day] => 13
    [month] => 4
    [year] => 2006
)

// 入力値に何らかの問題がある場合に、自動的に修正します
$date2 = Zend_Locale_Format::getDate('04.13.2006', array('date_format' => 'dd.MM.yyyy', 'fix_date' => true));

print_r($date); // 出力は、このようになります

Array
(
    [format] => dd.MM.yyyy
    [day] => 13
    [month] => 4
    [year] => 2006
    [fixed] => 4
)
?>

getDate() は "ロケール対応" なので、 $locale を指定することで そのロケールの書式の日付文字列を使用できます。 オプション 'fix_date' は、簡単なテストを行って 日付や月の妥当性を確認します。問題が見つかったら、 経験則によってそれを何とか修正しようとします。 'Zend_Locale_Format::STANDARD' を 'date_format' の値として指定すると、setOptions() で設定されているクラス全体のデフォルト日付書式を使用しないようにできます。 これにより、getDate は $locale のデフォルトの日付書式を使用するようになります。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
$date = Zend_Locale_Format::getDate('13.04.2006', array('date_format' => Zend_Locale_Format::STANDARD, 'locale' => $locale));

print_r ($date);
?>

入力に日付と時刻の両方が含まれている場合に、 完全な日付と時刻が返されます。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
$date = Zend_Locale_Format::getDate('13.04.2005 22:14:55', array('date_format' => Zend_Locale_Format::STANDARD, 'locale' => $locale);

print_r ($date);
?>

書式を指定したい場合は、 $locale ではなく $format 引数を指定します。 $format としてサポートされるのは、一文字のコード (H, m, s, y, M, d) および MMMM、EEEE だけです。

<?php
require_once 'Zend/Locale.php';

$date = Zend_Locale_Format::getDate('13200504T551422', array('date_format' => 'ddyyyyMM ssmmHH');

print_r ($date);
?>

書式には次の記号が使用できます。

適切な書式の例は、次のようになります。

	データベースの日付書式
	データベース (たとえば MySql や MsSql など) の日付値をパースするには、 getDate() のかわりに Zend_Date の ISO_8601 書式を使用します。

オプション 'fix_date' は、簡単なテストを行って 日付や月の妥当性を確認します。問題が見つかったら、 経験則によってそれを何とか修正しようとします。 getDate() は、 入力に問題がある場合にそれを自動で検出し、訂正します。 たとえば年の位置が違っている場合などがこれにあたります。

<?php
require_once 'Zend/Locale.php';

$date = Zend_Locale_Format::getDate('41.10.20', array('date_format' => 'ddMMyy', 'fix_date' => true));

// 41 は、日付ではなく年として返されます
print_r ($date);
?>

checkDateFormat($inputString, array('date_format' => $format, $locale)) を使用して、 指定した文字列が期待通りの日付を含むかどうかを調べます。 checkDateFormat() メソッドは getDate() を使用します。 しかし、オプション 'fixdate' は使用しません。これを使用すると、 入力が日付書式を満たしていない場合にも true を返してしまうからです。 月と日の位置が入れ替わっているなどのエラーが入力で検出された場合、 オプション 'fixdate' は 経験則によってそれを "修正" してから検証します。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
if (Zend_Locale_Format::checkDateFormat('13.Apr.2006', array('date_format' => Zend_Locale_Format::STANDARD, $locale)) {
    print "日付です";
} else {
    print "日付ではありません";
} 
?>

通常、入力に日付と時刻が両方含まれている場合は、 時刻は日付とともに返されます。 適切な書式はわからないが、ユーザの入力のロケールがわかるという場合に getTime() を使用します。 これは、選択したロケールに対するデフォルトの時刻書式を使用するからです。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
if (Zend_Locale_Format::getTime('13:44:42', array('date_format' => Zend_Locale_Format::STANDARD, 'locale' => $locale)) {
    print "時刻です";
} else {
    print "時刻ではありません";
} 
?>

checkDateFormat() を使用して、 指定した文字列が有効な時刻を含むかどうかを調べます。 使用法は、日付の確認の場合と同じです。ただし、 date_format には期待するパーツを指定しなければなりません。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
if (Zend_Locale_Format::checkDateFormat('13:44:42', array('date_format' => 'HH:mm:ss', 'locale' => $locale)) {
    print "時刻です";
} else {
    print "時刻ではありません";
} 
?>