日期辅助函数

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

装载本辅助函数

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

可用的函数如下:

now()

返回当前的 Unix 时间戳，根据你的config文件中"time reference"设定返回服务器当前时间或者GMT时间。如果你没有计划使用GMT时间(通常是你准备在站点中允许用户选择时区设置)，则此函数跟PHP中time()函数等同。

mdate()

这个函数跟PHP的内部函数date()几乎是一样的，区别在于，这个函数允许你使用在每个代码字母前带有百分号“%”的MySQL时间表达形式: %Y %m %d 等。

采用这种方式处理时间数据的优点在于，避免了你在使用date()函数时经常担心漏掉那些非时间的字符的问题。例如:

如果第二参数中不包含时间戳则使用当前时间。

standard_date()

允许你从一些标准格式生成日期字符串。例子：

第一个参数必须包含格式，第二个参数必须使用unix时间戳。

支持格式:

local_to_gmt()

将unix时间戳转换为GMT。例子:

gmt_to_local()

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

注意：时区列表请参考本页末。

mysql_to_unix()

将MySQL时间戳转换为unix时间戳。例子：

unix_to_human()

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

本函数可用于需要作为表单提交的地方。

时间可以设置为含或者不含秒数，而且可以设为欧洲或美国格式。如果只有时间戳，则格式化为不含秒数的美国格式。例子：

human_to_unix()

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

timespan()

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

第一参数必须是unix时间戳，第二个参数是一个大于第一参数的时间戳。如果第二参数空缺，则使用当前时间。这个函数的用途通常是计算过去某一个时间点到现在的时间之间的时间差。例如:

Note:由本函数生成的文字可以在以下语言文件中找到： language/<your_lang>/date_lang.php

days_in_month()

对给出的年月值返回天数。这个函数的实现已经考虑了存在闰年和平年的情况。例如:

如果省略第二参数则使用当前年。

timezones()

根据给定的时区参考(有效时区列表请参见下面的“时区参考”)返回跟UTC的相差值（小时）。

echo timezones('UM5');

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

timezone_menu()

生成一个时区下拉选单，像这样：

在你需要向你的网站会员提供他们所在时区的设置选项时这个选单会很有用的。

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

要得到这个选单的各个具体值，请看下面的时区参考表。

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

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

时区参考

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