日期辅助函数

日期辅助函数的文件涵盖了一些用于辅助日期数组操作的函数。

装载本辅助函数

本辅助函数的装载通过如下代码完成:

$this->load->helper('date');

$datestring = "Year: %Y Month: %m Day: %d - %h:%i %a";
$time = time();
echo mdate($datestring, $time);

$format = 'DATE_RFC822';
$time = time();
echo standard_date($format, $time);

$now = time();
$gmt = local_to_gmt($now);

gmt_to_local()

输入一个GMT的unix时间戳，根据时区、夏时制转换为本地时间戳。例子：

$timestamp = '1140153693';
$timezone  = 'UM8';
$daylight_saving = TRUE;
echo gmt_to_local($timestamp, $timezone, $daylight_saving);

$mysql = '20061124092345';
$unix = mysql_to_unix($mysql);

unix_to_human()

将unix时间戳转为如下人类可阅读格式：

YYYY-MM-DD HH:MM:SS AM/PM

$now = time();
echo unix_to_human($now); // U.S. time, no seconds
echo unix_to_human($now, TRUE, 'us'); // U.S. time with seconds
echo unix_to_human($now, TRUE, 'eu'); // Euro time with seconds

human_to_unix()

跟上面函数相反，这个函数将“人类”的时间表示方式（如，2008-12-31 04:38 PM）转换成unix的时间表示方式（如：1230713116）。这个函数在你接收一个从表单提交而来的“人类”的时间格式时会很有用。如果传递给这个函数的参数不是如上所说的“人类”时间格式的字符串，那么它将返回FALSE (boolean)。例如:

$now = time();
$human = unix_to_human($now);
$unix = human_to_unix($human);

timespan()

格式化unix时间戳使其看起来像这样：

1 Year, 10 Months, 2 Weeks, 5 Days, 10 Hours, 16 Minutes

$post_date = '1079621429';
$now = time();
echo timespan($post_date, $now);

echo days_in_month(06, 2005);

echo timezones('UM5');

本函数最有用是在使用timezone_menu()函数时.

timezone_menu()

生成一个时区下拉选单，像这样：在你需要向你的网站会员提供他们所在时区的设置选项时这个选单会很有用的。

第一个参数让你设置选单的“已选”状态。例如，你想将美国西部标准时间设为默认时间，你可以这样做：

echo timezone_menu('UM8');

第二个参数让你为选单设置CSS的类名。

注意:上面选单里的每个条目可以在这个文件语言文件里找到： language/<your_lang>/date_lang.php

时区参考

下面的表说明了各个时区值以及该值对应的地点

翻译贡献者:csfhc, Hex, Jacklee, mchong, pipi95, yinzhili