日期辅助函数

日期辅助函数文件包含了一些帮助你处理日期的函数。

• 加载辅助函数
• 可用函数
• 时区参考

加载辅助函数

该辅助函数通过下面的代码加载:

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

可用函数

该辅助函数有下列可用函数：

• now([$timezone = NULL])

参数:

• $timezone (string) — Timezone返回:UNIX timestamp返回类型:int

根据服务器的本地时间，以及一个 PHP 支持的时区参数或配置文件中的 "基准时间" 参数返回当前时间的 UNIX 时间戳，如果你不打算设置 "基准时间" （如果你的站点允许用户设置他们自己的时区，你通常需要设置这个），该函数就和 PHP 的 time() 函数没什么区别。

echo now('Australia/Victoria');

如果没有指定时区，该函数将使用 time_reference 参数调用 time() 函数。

• mdate([$datestr = ''[, $time = '']])

参数:

• $datestr (string) — Date string
• $time (int) — UNIX timestamp返回:MySQL-formatted date返回类型:string

该函数和 PHP 的 date() 函数一样，但是它支持 MySQL 风格的日期格式，在代码之前使用百分号，例如：%Y %m %d

使用这个函数的好处是你不用关心去转义那些不是日期代码的字符，如果使用 date() 函数时，你就要这么做。

例如:

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

如果第二个参数没有提供一个时间，那么默认会使用当前时间。

• standarddate([$fmt = 'DATERFC822'[, $time = NULL]])

参数:

• $fmt (string) — Date format
• $time (int) — UNIX timestamp返回:Formatted date or FALSE on invalid format返回类型:string

生成标准格式的时间字符串。

例如:

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

注解

该函数已经废弃，请使用原生的 date() 函数和时间格式化常量替代:

echo date(DATE_RFC822, time());

支持的格式：

ConstantDescriptionExampleDATE_ATOMAtom2005-08-15T16:13:03+0000DATE_COOKIEHTTP CookiesSun, 14 Aug 2005 16:13:03 UTCDATE_ISO8601ISO-86012005-08-14T16:13:03+00:00DATE_RFC822RFC 822Sun, 14 Aug 05 16:13:03 UTCDATE_RFC850RFC 850Sunday, 14-Aug-05 16:13:03 UTCDATE_RFC1036RFC 1036Sunday, 14-Aug-05 16:13:03 UTCDATE_RFC1123RFC 1123Sun, 14 Aug 2005 16:13:03 UTCDATE_RFC2822RFC 2822Sun, 14 Aug 2005 16:13:03 +0000DATE_RSSRSSSun, 14 Aug 2005 16:13:03 UTCDATE_W3CW3C2005-08-14T16:13:03+0000

• localto_gmt([$time = ''_])

参数:

• $time (int) — UNIX timestamp返回:UNIX timestamp返回类型:int

将时间转换为 GMT 时间。

例如:

$gmt = local_to_gmt(time());

• gmtto_local([$time = ''[, $timezone = 'UTC'[, $dst = FALSE_]]])

参数:

• $time (int) — UNIX timestamp
• $timezone (string) — Timezone
• $dst (bool) — Whether DST is active返回:UNIX timestamp返回类型:int

根据指定的时区和 DST （夏令时，Daylight Saving Time） 将 GMT 时间转换为本地时间。

例如:

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

注解

时区列表请参见本页末尾。

• mysqlto_unix([$time = ''_])

参数:

• $time (string) — MySQL timestamp返回:UNIX timestamp返回类型:int

将 MySQL 时间戳转换为 UNIX 时间戳。

例如:

$unix = mysql_to_unix('20061124092345');

• unixto_human([$time = ''[, $seconds = FALSE[, $fmt = 'us'_]]])

参数:

• $time (int) — UNIX timestamp
• $seconds (bool) — Whether to show seconds
• $fmt (string) — format (us or euro)返回:Formatted date返回类型:string

将 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

• humanto_unix([$datestr = ''_])

参数:

• $datestr (int) — Date string返回:UNIX timestamp or FALSE on failure返回类型:int

该函数和 unix_to_human() 函数相反，将一个方便人类阅读的时间格式转换为 UNIX 时间戳。这在当你需要在一个表单字段中显示日期时很有用。如果输入的时间不同于上面的格式，函数返回 FALSE 。

例如:

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

• nicedate([$baddate = ''[, $format = FALSE]])

参数:

• $bad_date (int) — The terribly formatted date-like string
• $format (string) — Date format to return (same as PHP's date() function)返回:Formatted date返回类型:string

该函数解析一个没有格式化过的数字格式的日期，并将其转换为格式化的日期。它也能解析格式化好的日期。

默认该函数将返回 UNIX 时间戳，你也可以提供一个格式化字符串给第二个参数（和 PHP 的 date() 函数一样）。

例如:

$bad_date = '199605';
// Should Produce: 1996-05-01
$better_date = nice_date($bad_date, 'Y-m-d');
 
$bad_date = '9-11-2001';
// Should Produce: 2001-09-11
$better_date = nice_date($bad_date, 'Y-m-d');

注解

This function is DEPRECATED. Use PHP's native DateTime class instead.

• timespan([$seconds = 1[, $time = ''[, $units = '']]])

参数:

• $seconds (int) — Number of seconds
• $time (string) — UNIX timestamp
• $units (int) — Number of time units to display返回:Formatted time difference返回类型:string

将一个 UNIX 时间戳转换为以下这种格式:

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

第一个参数为一个 UNIX 时间戳，第二个参数是一个比第一个参数大的 UNIX 时间戳。第三个参数可选，用于限制要显示的时间单位个数。

如果第二个参数为空，将使用当前时间。

这个函数最常见的用途是，显示从过去某个时间点到当前时间经过了多少时间。

例如:

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

注解

该函数生成的本文可以在语言文件 language//date_lang.php 中找到。

• daysin_month([$month = 0[, $year = ''_]])

参数:

• $month (int) — a numeric month
• $year (int) — a numeric year返回:Count of days in the specified month返回类型:int

返回指定某个月的天数，会考虑闰年。

例如:

echo days_in_month(06, 2005);

如果第二个参数为空，将使用今年。

注解

该函数其实是原生的 cal_days_in_month() 函数的别名，如果它可用的话。

• daterange([$unixstart = ''[, $mixed = ''[, $is_unix = TRUE[, $format = 'Y-m-d']]]])

参数:

• $unix_start (int) — UNIX timestamp of the range start date
• $mixed (int) — UNIX timestamp of the range end date or interval in days
• $is_unix (bool) — set to FALSE if $mixed is not a timestamp
• $format (string) — Output date format, same as in date()返回:An array of dates返回类型:array

返回某一段时间的日期列表。

例如:

$range = date_range('2012-01-01', '2012-01-15');
echo "First 15 days of 2012:";
foreach ($range as $date)
{
    echo $date."\n";
}

• timezones([$tz = ''])

参数:

• $tz (string) — A numeric timezone返回:Hour difference from UTC返回类型:int

根据指定的时区（可用的时区列表参见下文的 "时区参考"）返回它的 UTC 时间偏移。

例如:

echo timezones('UM5');

这个函数和 timezone_menu() 函数一起使用时很有用。

• timezonemenu([$default = 'UTC'[, $class = ''[, $name = 'timezones'[, $attributes = ''_]]]])

参数:

• $default (string) — Timezone
• $class (string) — Class name
• $name (string) — Menu name
• $attributes (mixed) — HTML attributes返回:HTML drop down menu with time zones返回类型:string

该函数用于生成一个时区下拉菜单，像下面这样。(UTC -12:00) Baker/Howland Island(UTC -11:00) Samoa Time Zone, Niue(UTC -10:00) Hawaii-Aleutian Standard Time, Cook Islands, Tahiti(UTC -9:30) Marquesas Islands(UTC -9:00) Alaska Standard Time, Gambier Islands(UTC -8:00) Pacific Standard Time, Clipperton Island(UTC -7:00) Mountain Standard Time(UTC -6:00) Central Standard Time(UTC -5:00) Eastern Standard Time, Western Caribbean Standard Time(UTC -4:30) Venezuelan Standard Time(UTC -4:00) Atlantic Standard Time, Eastern Caribbean Standard Time(UTC -3:30) Newfoundland Standard Time(UTC -3:00) Argentina, Brazil, French Guiana, Uruguay(UTC -2:00) South Georgia/South Sandwich Islands(UTC -1:00) Azores, Cape Verde Islands(UTC) Greenwich Mean Time, Western European Time(UTC +1:00) Central European Time, West Africa Time(UTC +2:00) Central Africa Time, Eastern European Time, Kaliningrad Time(UTC +3:00) Moscow Time, East Africa Time(UTC +3:30) Iran Standard Time(UTC +4:00) Azerbaijan Standard Time, Samara Time(UTC +4:30) Afghanistan(UTC +5:00) Pakistan Standard Time, Yekaterinburg Time(UTC +5:30) Indian Standard Time, Sri Lanka Time(UTC +5:45) Nepal Time(UTC +6:00) Bangladesh Standard Time, Bhutan Time, Omsk Time(UTC +6:30) Cocos Islands, Myanmar(UTC +7:00) Krasnoyarsk Time, Cambodia, Laos, Thailand, Vietnam(UTC +8:00) Australian Western Standard Time, Beijing Time, Irkutsk Time(UTC +8:45) Australian Central Western Standard Time(UTC +9:00) Japan Standard Time, Korea Standard Time, Yakutsk Time(UTC +9:30) Australian Central Standard Time(UTC +10:00) Australian Eastern Standard Time, Vladivostok Time(UTC +10:30) Lord Howe Island(UTC +11:00) Srednekolymsk Time, Solomon Islands, Vanuatu(UTC +11:30) Norfolk Island(UTC +12:00) Fiji, Gilbert Islands, Kamchatka Time, New Zealand Standard Time(UTC +12:45) Chatham Islands Standard Time(UTC +13:00) Phoenix Islands Time, Tonga(UTC +14:00) Line Islands当你的站点允许用户选择自己的本地时区时，这个菜单会很有用。

第一个参数为菜单默认选定的时区，例如，要设置太平洋时间为默认值，你可以这样:

echo timezone_menu('UM8');

菜单中的值请参见下面的时区参考。

第二个参数用于为菜单设置一个 CSS 类名。

第四个参数用于为生成的 select 标签设置一个或多个属性。

注解

菜单中的文本可以在语言文件 language//date_lang.php 中找到。

时区参考

下表列出了每个时区和它所对应的位置。

注意，为了表述清晰和格式工整，有些位置信息做了适当的删减。