检查日期

大部分输入的日期可能是字符串，问题是你不能确保这些字符串是真的日期。因此 Zend_Date 有个特有的静态函数来加查日期字符串。Zend_Locale 有个特有的函数 getDate($date, $locale); ，它解析日期并返回正确的格式化的日期部分。例如月名将被识别和返回月数。但 Zend_Locale 不知道什么是日期，因为它是个格式化和本地化的类，所以我们集成了一个特有的函数 isDate($date); 来做这个。

isDate($date, $format, $locale); 最多可以带 3 个参数但最少需要一个参数。所以我们需要校验的日期当然是它本身是否一个字符串。第二个参数是日期的格式。如果没有给定格式，使用地方的标准格式。关于格式的细节参见自定义格式。

第三个参数也是可选的并可用于给定一个地方。我们需要地方来格式化月名和天名（monthnames and daynames）。所以用第三个参数我们可以根据给定的地方识别 '01.Jänner.2000' 或 '01.January.2000'这样的日期。

isDate(); 当然来检查是否一个日期存在。Zend_Date自己不检查日期。所以有可能用 Zend_Date 生成一个如 '31.February.2000'的日期，因为 Zend_Date 将自动纠正日期并返回适当的日期，在这个例子中为 '03.March.2000' 。而 isDate() 将检查并对 '31.February.2000' 返回 false，因为它知道这是个不可能的日期。

Example #1 检查日期

// Checking dates
$date = '01.03.2000';
if (Zend_Date::isDate($date)) {
    print "String $date is a date";
} else {
    print "String $date is NO date";
}

// Checking localized dates
$date = '01 February 2000';
if (Zend_Date::isDate($date,'dd MMMM yyyy', 'en')) {
    print "String $date is a date";
} else {
    print "String $date is NO date";
}

// Checking impossible dates
$date = '30 February 2000';
if (Zend_Date::isDate($date,'dd MMMM yyyy', 'en')) {
    print "String $date is a date";
} else {
    print "String $date is NO date";
}

日出和日落

Zend_Date 也集成了从太阳获得信息的功能。通常在一个特定的日子里获得日出和日落的时间是有必要的。用Zend_Date 来做很容易，因为仅仅给定位置就可以计算到日出日落的时间。

正如很多人不知道他们所居住的城市的位置，我们也使用助手类来提供了世界上大约 250个首都和其它大城市的位置数据。大多数人使用他们附近的城市来作为地方，这样计算上会差一点时间。

用 Zend_Date_Cities::getCityList 可以生成一个列表来选择城市。它返回所有在助手类中预定义的可用的城市名称。

Example #2 获得所有可用的城市

// Output the complete list of available cities
print_r (Zend_Date_Cities::getCityList());

用 Zend_Date_Cities::City() 函数可以获得位置。它接受由 Zend_Date_Cities::getCityList() 函数返回的城市名和可选的第二个参数来设置地平线（horizon）.

'effective' horizon is used. 有 4 个已定义的地平线可用于位置类精确计算日落和日出。'horizon' 参数在所有的函数中总是可选的。如果没有指定，则使用 'effective' 。

**日落和日出支持的地平线（horizons）类型**
地平线（Horizon）	描述	用法
effective	标准地平线	认为世界是一个球。这个地平线是缺省值
civil	通用地平线	常用于媒体如电视和电台
nautic	水兵地平线	常用于大海导航
astronomic	天文学地平线	常用于星际计算

当然也可以给出和计算自定义位置，因此 'latitude' 和 'longitude' 必需给定，而 'horizon' 是可选的。

Example #3 获得一个城市的位置

// Get the location for a defined city
// uses the effective horizon as no horizon is defined
print_r (Zend_Date_Cities::City('Vienna'));

// use the nautic horizon
print_r (Zend_Date_Cities::City('Vienna', 'nautic'));

// self definition of a location
$mylocation = array('latitude' => 41.5, 'longitude' => 13.2446);

现在所有需要的数据可以被设置了，下一步是创建带有计算日落和日出的日期的 Zend_Date 对象。有三个函数用于计算，用 'getSunset()' 计算日落，用 'getSunrise()' 计算日出，所有和太阳相关的信息使用 'getSunInfo()' 。经过计算后，Zend_Date 对象返回时就带有计算过的时间。

Example #4 计算太阳信息

// Get the location for a defined city
$city = Zend_Date_Cities::City('Vienna');

// create a date object for the day for which the sun has to be calculated
$date = new Zend_Date('10.03.2007', Zend_Date::ISO_8601, 'de');

// calculate sunset
$sunset = $date->getSunset($city);
print $sunset->get(Zend_Date::ISO_8601);

// calculate all sun informations
$info = $date->getSunInfo($city);
foreach ($info as $sun) {
    print "\n" . $sun->get(Zend_Date::ISO_8601);
}

时区

时区和日期一样重要，根据用户所居住的地方，有若干时区，所以使用日期意味着要正确设置时区。这听起来很复杂但其实比较简单。正如在 Zend_Date 的第一章所提到的，缺省的时区已经通过 php.ini 或在引导文件（bootstrap file）里定义来设置，

Zend_Date 对象当然也存储实际的时区。即使在对象创建后修改时区，它也能记住原来的时区并使用它。也不必要在使用php函数的代码里修改时区，Zend_Date 有两个内置的函数来处理这个。

getTimezone() 返回实际的在 Zend_Date 对象里的时区。请记住 Zend_Date 在内部不和 php 耦合，返回的时区不是 php 脚本的时区二是对象的时区。 setTimezone($zone) 是第二个函数并为 Zend_Date 设置新时区。给定的时区总是被检查的，如果不存在就抛出异常。另外通过不带区域参数调用 setTimezone() 实际脚本或系统时区可以被设置到日期对象，在对象被创建是这个也会自动完成。

Example #5 使用时区

// Set a default timezone... this has to be done within the bootstrap
// file or php.ini
// We do this here just for having a complete example
date_default_timezone_set('Europe/Vienna');

// create a date object
$date = new Zend_Date('10.03.2007', Zend_Date::DATES, 'de');

// view our date object
print $date->getIso();

// what timezone do we have ?
print $date->getTimezone();

// set another timezone
$date->setTimezone('America/Chicago');

// what timezone do we now have ?
print $date->getTimezone();

// see the changed date object
print $date->getIso();

如上面例子的第一行所示，Zend_Date 对创建对象总是使用实际的时区。在被创建的对象里修改时区对日期自己有影响。日期总是和时区相关。对 Zend_Date 对象修改时区不会修改 Zend_Date 的时间。请记住在内部日期总是以时间戳和 GMT 时区存储。所以时区就意味者对用户所在时区和地区对实际的国际时间的加减。

在 Zend_Date 里耦合时区有另一个正面影响，在不同的时区有可能有若干个日期。

Example #6 多重时区

// Set a default timezone... this has to be done within the bootstrap
// file or php.ini.
// We do this here just for having a complete example.
date_default_timezone_set('Europe/Vienna');

// create a date object
$date = new Zend_Date('10.03.2007 00:00:00', Zend_Date::ISO_8601, 'de');

// view our date object
print $date->getIso();

// the date stays unchanged even after changeing the timezone
date_default_timezone_set('America/Chicago');
print $date->getIso();

$otherdate = clone $date;
$otherdate->setTimezone('Brazil/Acre');

// view our date object
print $otherdate->getIso();

// set the object to the actual systems timezone
$lastdate = clone $date;
$lastdate->setTimezone();

// view our date object
print $lastdate->getIso();

Working 范例

检查日期

日出和日落

时区