- 欢迎使用 CodeIgniter
- 安装说明
- 下载 CodeIgniter
- 从老版本升级
- 疑难解答
- CodeIgniter 概览
- CodeIgniter 将从这里开始
- CodeIgniter 概览
- CodeIgniter 特性
- 应用程序流程图
- 模型-视图-控制器
- 设计与架构目标
- 教程 - 内容提要
- 加载静态内容
- 读取新闻条目
- 创建新闻条目
- 结束语
- 向 CodeIgniter 贡献你的力量
- 编写 CodeIgniter 的文档
- Developer's Certificate of Origin 1.1
- CodeIgniter URL
- 控制器
- 保留名称
- 视图
- 模型
- 辅助函数
- 使用 CodeIgniter 类库
- 创建类库
- 使用 CodeIgniter 驱动器
- 创建驱动器
- 创建核心系统类
- 创建附属类
- 钩子 - 扩展框架核心
- 自动加载资源
- 公共函数
- 兼容性函数
- URI 路由
- 错误处理
- 网页缓存
- 程序分析
- 以 CLI 方式运行
- 管理你的应用程序
- 处理多环境
- 在视图文件中使用 PHP 替代语法
- 安全
- PHP 开发规范
- 基准测试类
- 缓存驱动器
- 日历类
- 购物车类
- 配置类
- Email 类
- 加密类
- 加密类(新版)
- 文件上传类
- 表单验证类
- FTP 类
- 图像处理类
- 输入类
- Javascript 类
- 语言类
- 加载器类
- 迁移类
- 输出类
- 分页类
- 模板解析类
- 安全类
- Session 类
- HTML 表格类
- 引用通告类
- 排版类
- 单元测试类
- URI 类
- 用户代理类
- XML-RPC 与 XML-RPC 服务器类
- Zip 编码类
- 数据库参考
- 数据库快速入门: 示例代码
- 数据库配置
- 连接你的数据库
- 查询
- 生成查询结果
- 查询辅助函数
- 查询构造器类
- 事务
- 数据库元数据
- 自定义函数调用
- 数据库缓存类
- 数据库工厂类
- 数据库工具类
- 数据库驱动器参考
- 数组辅助函数
- 验证码辅助函数
- Cookie 辅助函数
- 日期辅助函数
- 目录辅助函数
- 下载辅助函数
- 邮件辅助函数
- 文件辅助函数
- 表单辅助函数
- HTML 辅助函数
- Inflector 辅助函数
- 语言辅助函数
- 数字辅助函数
- 路径辅助函数
- 安全辅助函数
- 表情辅助函数
- 字符串辅助函数
- 文本辅助函数
- 排版辅助函数
- URL 辅助函数
- XML 辅助函数
- The MIT License (MIT)
- 服务器要求
- 关于 CodeIgniter
日期辅助函数
日期辅助函数文件包含了一些帮助你处理日期的函数。
- 加载辅助函数
- 可用函数
- 时区参考
加载辅助函数
该辅助函数通过下面的代码加载:
$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);
如果第二个参数没有提供一个时间,那么默认会使用当前时间。
- standard_date([$fmt = 'DATE_RFC822'[, $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());
支持的格式:
Constant Description Example DATE_ATOM Atom 2005-08-15T16:13:03+0000 DATE_COOKIE HTTP Cookies Sun, 14 Aug 2005 16:13:03 UTC DATE_ISO8601 ISO-8601 2005-08-14T16:13:03+00:00 DATE_RFC822 RFC 822 Sun, 14 Aug 05 16:13:03 UTC DATE_RFC850 RFC 850 Sunday, 14-Aug-05 16:13:03 UTC DATE_RFC1036 RFC 1036 Sunday, 14-Aug-05 16:13:03 UTC DATE_RFC1123 RFC 1123 Sun, 14 Aug 2005 16:13:03 UTC DATE_RFC2822 RFC 2822 Sun, 14 Aug 2005 16:13:03 +0000 DATE_RSS RSS Sun, 14 Aug 2005 16:13:03 UTC DATE_W3C W3C 2005-08-14T16:13:03+0000
- local_to_gmt([$time = ''])
参数: - $time (int) -- UNIX timestamp
返回: UNIX timestamp
返回类型: int
将时间转换为 GMT 时间。
例如:
$gmt = local_to_gmt(time());
- gmt_to_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);
注解
时区列表请参见本页末尾。
- mysql_to_unix([$time = ''])
参数: - $time (string) -- MySQL timestamp
返回: UNIX timestamp
返回类型: int
将 MySQL 时间戳转换为 UNIX 时间戳。
例如:
$unix = mysql_to_unix('20061124092345');
- unix_to_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
- human_to_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);
- nice_date([$bad_date = ''[, $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/<your_lang>/date_lang.php 中找到。
- days_in_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() 函数的别名,如果它可用的话。
- date_range([$unix_start = ''[, $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() 函数一起使用时很有用。
参数: - $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/<your_lang>/date_lang.php 中找到。
时区参考
下表列出了每个时区和它所对应的位置。
注意,为了表述清晰和格式工整,有些位置信息做了适当的删减。
时区 | 位置 |
---|---|
UM12 | (UTC - 12:00) 贝克岛、豪兰岛 |
UM11 | (UTC - 11:00) 萨摩亚时区、纽埃 |
UM10 | (UTC - 10:00) 夏威夷-阿留申标准时间、库克群岛 |
UM95 | (UTC - 09:30) 马克萨斯群岛 |
UM9 | (UTC - 09:00) 阿拉斯加标准时间、甘比尔群岛 |
UM8 | (UTC - 08:00) 太平洋标准时间、克利珀顿岛 |
UM7 | (UTC - 07:00) 山区标准时间 |
UM6 | (UTC - 06:00) 中部标准时间 |
UM5 | (UTC - 05:00) 东部标准时间、西加勒比 |
UM45 | (UTC - 04:30) 委内瑞拉标准时间 |
UM4 | (UTC - 04:00) 大西洋标准时间、东加勒比 |
UM35 | (UTC - 03:30) 纽芬兰标准时间 |
UM3 | (UTC - 03:00) 阿根廷、巴西、法属圭亚那、乌拉圭 |
UM2 | (UTC - 02:00) 南乔治亚岛、南桑威奇群岛 |
UM1 | (UTC -1:00) 亚速尔群岛、佛得角群岛 |
UTC | (UTC) 格林尼治标准时间、西欧时间 |
UP1 | (UTC +1:00) 中欧时间、西非时间 |
UP2 | (UTC +2:00) 中非时间、东欧时间 |
UP3 | (UTC +3:00) 莫斯科时间、东非时间 |
UP35 | (UTC +3:30) 伊朗标准时间 |
UP4 | (UTC +4:00) 阿塞拜疆标准时间、萨马拉时间 |
UP45 | (UTC +4:30) 阿富汗 |
UP5 | (UTC +5:00) 巴基斯坦标准时间、叶卡捷琳堡时间 |
UP55 | (UTC +5:30) 印度标准时间、斯里兰卡时间 |
UP575 | (UTC +5:45) 尼泊尔时间 |
UP6 | (UTC +6:00) 孟加拉国标准时间、不丹时间、鄂木斯克时间 |
UP65 | (UTC +6:30) 可可岛、缅甸 |
UP7 | (UTC +7:00) 克拉斯诺亚尔斯克时间、柬埔寨、老挝、泰国、越南 |
UP8 | (UTC +8:00) 澳大利亚西部标准时间、北京时间 |
UP875 | (UTC +8:45) 澳大利亚中西部标准时间 |
UP9 | (UTC +9:00) 日本标准时间、韩国标准时间、雅库茨克 |
UP95 | (UTC +9:30) 澳大利亚中部标准时间 |
UP10 | (UTC +10:00) 澳大利亚东部标准时间、海参崴时间 |
UP105 | (UTC +10:30) 豪勋爵岛 |
UP11 | (UTC +11:00) 中科雷姆斯克时间、所罗门群岛、瓦努阿图 |
UP115 | (UTC +11:30) 诺福克岛 |
UP12 | (UTC +12:00) 斐济、吉尔伯特群岛、堪察加半岛、新西兰 |
UP1275 | (UTC +12:45) 查塔姆群岛标准时间 |
UP13 | (UTC +13:00) 凤凰岛、汤加 |
UP14 | (UTC +14:00) 莱恩群岛 |
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论