- 欢迎使用 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
日历类
使用日历类可以让你动态的创建日历,并且可以使用日历模板来格式化显示你的日历, 允许你 100% 的控制它设计的每个方面。另外,你还可以向日历的单元格传递数据。
- 使用日历类
- 初始化类
- 显示一个日历
- 传数据到单元格
- 设置显示参数
- 显示下一月/上一月链接
- 创建一个日历模板
- 类参考
使用日历类
初始化类
跟 CodeIgniter 中的其他类一样,可以在你的控制器中使用 $this->load->library() 方法加载日历类:
$this->load->library('calendar');
一旦加载,日历类就可以像下面这样使用:
$this->calendar
显示一个日历
这里是一个简单的例子,告诉你如何去显示一个日历:
$this->load->library('calendar'); echo $this->calendar->generate();
上面的代码将根据你服务器时间创建一个当前月/年的日历。要显示一个指定月和年的日历, 你要传递这些信息到日历生成函数:
$this->load->library('calendar'); echo $this->calendar->generate(2006, 6);
上面的代码将创建一个显示 2006 年 6 月的日历,第一个参数指定了年,第二个参数指定了月。
传数据到单元格
如果需要添加数据到日历的单元格中,就要创建一个关联数组,这个数组中索引是想添加数据的日期, 数组对应的值是想添加的数据。该数组通过日历生成函数的第三个参数被传入,参考下面这个例子:
$this->load->library('calendar'); $data = array( 3 => 'http://example.com/news/article/2006/06/03/', 7 => 'http://example.com/news/article/2006/06/07/', 13 => 'http://example.com/news/article/2006/06/13/', 26 => 'http://example.com/news/article/2006/06/26/' ); echo $this->calendar->generate(2006, 6, $data);
使用上面的例子,天数为 3、7、13 和 26 将变成链接指向你提供的 URL 。
注解
默认情况下,系统假定你的数组中包含了链接。在下面介绍日历模板的部分, 你会看到你可以自定义处理传入日历单元格的数据,所以你可以传不同类型的信息。
设置显示参数
有 8 种不同的参数可以让你设置日历的各个方面,你可以通过加载函数的第二个参数来设置参数。 例如:
$prefs = array( 'start_day' => 'saturday', 'month_type' => 'long', 'day_type' => 'short' ); $this->load->library('calendar', $prefs); echo $this->calendar->generate();
上面的代码将显示一个日历从礼拜六开始,使用用完整的月份标题和缩写的天数格式。 更多参数信息请看下面。
参数 | 默认值 | 选项 | 描述 |
---|---|---|---|
template | None | None | 字符串或数组,包含了你的日历模板,见下面的模板部分。 |
local_time | time() | None | 当前时间的 Unix 时间戳。 |
start_day | sunday | Any week day (sunday, monday, tuesday, etc.) | 指定每周的第一天是周几。 |
month_type | long | long, short | 月份的显示样式(long = January, short = Jan) |
day_type | abr | long, short, abr | 星期的显示样式(long = Sunday, short = Sun, abr = Su) |
show_next_prev | FALSE | TRUE/FALSE (boolean) | 是否显示 "上个月" 和 "下个月" 链接,见下文。 |
next_prev_url | controller/method | A URL | 设置 "上个月" 和 "下个月" 的链接地址。 |
show_other_days | FALSE | TRUE/FALSE (boolean) | 是否显示第一周和最后一周相邻月份的日期。 |
显示下一月/上一月链接
要让你的日历通过下一月/上一月链接动态的减少/增加,可以仿照下面的例子建立你的日历:
$prefs = array( 'show_next_prev' => TRUE, 'next_prev_url' => 'http://example.com/index.php/calendar/show/' ); $this->load->library('calendar', $prefs); echo $this->calendar->generate($this->uri->segment(3), $this->uri->segment(4));
在上面的例子中,你会注意到这几点:
- "show_next_prev" 参数必须设置为 TRUE
- "next_prev_url" 参数必须设置一个 URL ,如果不设置,会默认使用当前的 控制器/方法
- 通过 URI 的段将 "年" 和 "月" 参数传递给日历生成函数(日历类会自动添加 "年" 和 "月" 到你提供的 URL)
创建一个日历模板
通过创建一个日历模板你能够 100% 的控制你的日历的设计。当使用字符串方式设置模板时, 日历的每一部分都要被放在一对伪变量中,像下面这样:
$prefs['template'] = ' {table_open}<table border="0" cellpadding="0" cellspacing="0">{/table_open} {heading_row_start}<tr>{/heading_row_start} {heading_previous_cell}<th><a href="{previous_url}"><<</a></th>{/heading_previous_cell} {heading_title_cell}<th colspan="{colspan}">{heading}</th>{/heading_title_cell} {heading_next_cell}<th><a href="{next_url}">>></a></th>{/heading_next_cell} {heading_row_end}</tr>{/heading_row_end} {week_row_start}<tr>{/week_row_start} {week_day_cell}<td>{week_day}</td>{/week_day_cell} {week_row_end}</tr>{/week_row_end} {cal_row_start}<tr>{/cal_row_start} {cal_cell_start}<td>{/cal_cell_start} {cal_cell_start_today}<td>{/cal_cell_start_today} {cal_cell_start_other}<td class="other-month">{/cal_cell_start_other} {cal_cell_content}<a href="{content}">{day}</a>{/cal_cell_content} {cal_cell_content_today}<div class="highlight"><a href="{content}">{day}</a></div>{/cal_cell_content_today} {cal_cell_no_content}{day}{/cal_cell_no_content} {cal_cell_no_content_today}<div class="highlight">{day}</div>{/cal_cell_no_content_today} {cal_cell_blank} {/cal_cell_blank} {cal_cell_other}{day}{/cal_cel_other} {cal_cell_end}</td>{/cal_cell_end} {cal_cell_end_today}</td>{/cal_cell_end_today} {cal_cell_end_other}</td>{/cal_cell_end_other} {cal_row_end}</tr>{/cal_row_end} {table_close}</table>{/table_close} '; $this->load->library('calendar', $prefs); echo $this->calendar->generate();
当使用数组方式设置模板时,你需要传递 key => value 键值对,你可以只设置你想设置的参数, 其他没有设置的参数会使用日历类的默认值代替。
例子:
$prefs['template'] = array( 'table_open' => '<table class="calendar">', 'cal_cell_start' => '<td class="day">', 'cal_cell_start_today' => '<td class="today">' ); $this->load->library('calendar', $prefs); echo $this->calendar->generate();
类参考
- class CI_Calendar
- initialize([$config = array()])
参数: - $config (array) -- Configuration parameters
返回: CI_Calendar instance (method chaining)
返回类型: CI_Calendar
初始化日历类参数,输入参数为一个关联数组,包含了日历的显示参数。
- generate([$year = ''[, $month = ''[, $data = array()]]])
参数: - $year (int) -- Year
- $month (int) -- Month
- $data (array) -- Data to be shown in the calendar cells
返回: HTML-formatted calendar
返回类型: string
生成日历。
- get_month_name($month)
参数: - $month (int) -- Month
返回: Month name
返回类型: string
提供数字格式的月份,返回月份的名称。
- get_day_names($day_type = '')
参数: - $day_type (string) -- 'long', 'short', or 'abr'
返回: Array of day names
返回类型: array
根据类型返回一个包含星期名称(Sunday、Monday 等等)的数组,类型有:long、short 和 abr 。 如果没有指定 $day_type 参数(或该参数无效),方法默认使用 abr(缩写) 格式。
- adjust_date($month, $year)
参数: - $month (int) -- Month
- $year (int) -- Year
返回: An associative array containing month and year
返回类型: array
该方法调整日期确保日期有效。例如,如果你将月份设置为 13 ,年份将自动加 1 ,并且月份变为一月:
print_r($this->calendar->adjust_date(13, 2014));
输出:
Array ( [month] => '01' [year] => '2015' )
- get_total_days($month, $year)
参数: - $month (int) -- Month
- $year (int) -- Year
返回: Count of days in the specified month
返回类型: int
获取指定月的天数:
echo $this->calendar->get_total_days(2, 2012); // 29
注解
该方法是 日期辅助函数 的 days_in_month() 函数的别名。
- default_template()
返回: An array of template values 返回类型: array 默认的模板,当你没有使用你自己的模板时将会使用该方法。
- parse_template()
返回: CI_Calendar instance (method chaining) 返回类型: CI_Calendar 解析模板中的伪变量 {pseudo-variables} 显示日历。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论