日历类 · CodeIgniter3.0 中文用户指南

# 日历类使用日历类可以让你动态的创建日历，并且可以使用日历模板来格式化显示你的日历，允许你 100% 的控制它设计的每个方面。另外，你还可以向日历的单元格传递数据。 [TOC=2,3] ## 使用日历类 ### 初始化类跟 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/03/', 7 => 'http://example.com/news/article/2006/07/', 13 => 'http://example.com/news/article/2006/13/', 26 => 'http://example.com/news/article/2006/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(); ~~~ ## 类参考 classCI_Calendar >[info] ### initialize([$config = array()]) 参数: * **$config** (array) -- Configuration parameters 返回: CI_Calendar instance (method chaining) 返回类型: CI_Calendar 初始化日历类参数，输入参数为一个关联数组，包含了日历的显示参数。 >[info] ### 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 生成日历。 >[info] ### get_month_name($month) 参数: * **$month** (int) -- Month 返回: Month name 返回类型: string 提供数字格式的月份，返回月份的名称。 >[info] ### 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（缩写）格式。 >[info] ### 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' ) ~~~ >[info] ### 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 ~~~ > 注解 > 该方法是 [日期辅助函数](http://codeigniter.org.cn/user_guide/helpers/date_helper.html) 的 [days_in_month()](http://codeigniter.org.cn/user_guide/helpers/date_helper.html#days_in_month "days_in_month") 函数的别名。 >[info] ### default_template() 返回: An array of template values 返回类型: array 默认的模板，当你没有使用你自己的模板时将会使用该方法。 >[info] ### parse_template() 返回: CI_Calendar instance (method chaining) 返回类型: CI_Calendar 解析模板中的伪变量 {pseudo-variables} 显示日历。