日期辅助函数

日期辅助函数文件包含协助处理日期的函数。

备注

许多之前在 CodeIgniter 3 date_helper 中的函数已经移动到 CodeIgniter 4 的 Time 类中。

加载此辅助函数

使用以下代码加载此辅助函数：

<?php

helper('date');

可用函数

提供以下函数：

now([$timezone = null])
参数:

  • $timezone (string) -- 时区

返回:

UNIX 时间戳

返回类型:

int

备注

推荐改为使用 Time 类。使用 Time::now()->getTimestamp() 获取当前 UNIX 时间戳。

如果没有提供时区，将通过 time() 返回当前 UNIX 时间戳。

<?php

echo now();

如果提供了任何 PHP 支持的时区，它将返回一个根据时差偏移后的时间戳。这与当前的（标准）UNIX 时间戳不同。

如果你不打算将主时间基准设置为其他 PHP 支持的时区（通常只有在运行允许用户自定义时区的网站时才会这样做），那么使用此函数相比 PHP 原生的 time() 函数并没有任何优势。

timezone_select([$class = '', $default = '', $what = \DateTimeZone::ALL, $country = null])
参数:

  • $class (string) -- 应用于选择字段的可选类

  • $default (string) -- 初始选择的默认值

  • $what (int) -- DateTimeZone 类常量（参见 listIdentifiers）

  • $country (string) --

    两位字母的 ISO 3166-1 兼容的国家代码（参见 listIdentifiers）

返回:

预格式化的 HTML 选择字段

返回类型:

string

生成一个包含可用时区的 select 表单字段（即下拉菜单，可根据 $what 和 $country 参数进行筛选）。 你可以提供一个 CSS 类应用到该字段以简化样式设置，同时也可以指定一个默认选中值。

<?php

echo timezone_select('custom-select', 'America/New_York');