rtablada/calendar

此包已被废弃且不再维护。未建议替代包。
此包最新版本(dev-master)的许可证信息不可用。

dev-master 2013-10-24 21:42 UTC

This package is not auto-updated.

Last update: 2022-02-01 12:27:53 UTC


README

Laravel 4 Calendar Helper 提供了几个方便的方法来处理 Laravel 4 中的日期和日历。其核心功能是获取基于查询字符串参数 daymonthyear 的当前日期。

使用 Laravel 4 Calendar

在你的 app/config/app.php 配置文件中,将 Rtablada\Calendar\CalendarServiceProvider 添加到服务提供者,并将 'Calendar' => 'Rtablada\Calendar\CalendarFacade' 添加到配置。

现在你可以调用 Calendar::getDateFromInput() 来获取当前日期加上使用用户输入进行的任何修改。

函数

getDateFromInput

此函数可以接受多种格式来修改在输入包中修改之前使用的日期。

当未传递任何参数时,此函数将使用当前系统日期。可以将 Carbon 实例传递给函数作为起始日期。如果传递数组,可以指定 daymonthyear 键。如果某个键被省略,则使用当前系统日期该键的值。否则,可以按 getDateFromInput($day, $month, $year) 的方式传递参数,如果任何参数被省略,则使用当前系统日期该参数的值。

yearLinks

此函数将返回一个具有选择年份链接的 View 对象。

yearLinks 函数接受几个参数:

  1. selectedDate - 此值将发送到 getDateFromInput 函数以显示当前日期,如果您想覆盖默认值而不是用户输入的情况。
  2. startYear - 创建链接的起始年份,如果省略或传递 null,则使用计算出的 selectedDate 一年前的年份。
  3. endYear - 创建链接的结束年份,如果省略或传递 null,则使用计算出的 selectedDate 一年后的年份。
  4. options - 请参阅以下选项参数部分。

monthLinks 和 dayLinks

这些函数返回具有选择月份或日期链接的 View 对象。

这些函数接受两个参数:

  1. selectedDate - 此值将发送到 getDateFromInput 函数以显示当前日期,如果您想覆盖默认值而不是用户输入的情况。
  2. options - 请参阅以下选项参数部分。

选项参数

options 参数接受一个键值数组,允许您指定一些不同的显示选项,当前可用的键包括:

  1. before_current
  2. before_selected
  3. after_current
  4. after_selected

如果您将某个键的值设置为 hide,则这些选项将被隐藏。否则,该值将作为应用于匹配日期链接的HTML类使用。