Unity日历选择器ZCalendar，使用说明

xiaozongpeng · 发表于 2022-9-3 11:57

前言

因工作需要，又找不到合适的，学习成本又低的日历组件，自己封装一套，也提供给小伙伴们一同使用，如有任何可优化的地方，也烦请各位大佬友情提出，感恩的

效果展示：

可配置显示项：

1、可自定义初始化时间
2、可控制显示前后月的日期显示
3、可控制显示农历日期
4、可做静态日历显示
5、尺寸自适应
6、可控制超出当前日期是否可以点击
7、如果做为弹窗使用，点击周围可隐藏控件
8、可选择时间范围

安装方法：

1、gitee【Jacobkay/unity日历】上拉取代码及资源
2、将ZCalendar文件夹直接拖入工程内
3、将Prefabs/Zcalendar拖入到canvas下，即可使用

配置说明：

Awake2Init：true => 以当前时间初始化，false => 不初始化，可通过ZCalendar中的Init方法初始化；
AutoFillDate：true => 自动补充前后月日期，false => 不显示前后月日期；
IsUnexpiredTimeCanClick：true => 超出当前时间可点击，false => 超出当前时间不可点击；
Lunar：true => 显示农历日期，false => 不显示农历日期;
IsPopupCalendar：true => 显示时，点击周边或者点击日期可隐藏日历，如果默认为隐藏状态，可关闭子对象bak，本身有管理脚本，不可隐藏，false => 为长显示日历
IsStaticCalendar：true => 为静态日期显示日历，不可操作，false => 可操作日历
AutoSetItemSize：true => 日期显示部分可根据尺寸自适应显示，false => 不会自适应显示
RangeCalendar：true => 可选择时间范围，false => 可选择单天日期

预制体说明：

Zcalendar：日历预制体，将此预制体拖到canvas下，即可使用
ZCalendarDayItem：日历中天的预制体，可对其进行扩展

      RangeImageBak：区间时间选择时，背景图
      IsOnImage：选中时，背景图
      Text：当前时间显示
      Lunar：农历
注意：如果大佬们只是使用，没有优化想法，挂载的组件及布局不可修改，但可扩展添加需用组件

脚本说明：

1、ZCalendar.cs：程序入口，API接口
2、ZCalendarController：逻辑控制器
3、ZCalendarModel：日历模型
4、ZCalendarDayItem：日历中每一天的时间对象
API（ZCalendar中）：

1、在切换月份或者年份时，可获取到每一个日期对象
public event Action<ZCalendarDayItem> UpdateDateEvent;
2、切换日期时，可获取到选择的某一天
public event Action<ZCalendarDayItem> ChoiceDayEvent;
3、监听区间时间选择，获取选择的时间对象
public event Action<ZCalendarDayItem, ZCalendarDayItem> RangeTimeEvent;
4、日历加载结束时
public event Action CompleteEvent;
5、手动获取当前选中的时间对象
public ZCalendarDayItem CrtTime { get; set; }
6、按照当前时间初始化
public void Init()
7、按照DateTime格式初始化
public void Init(DateTime dateTime)
8、按照string，YYYY-MM-DD格式初始化日历
public void Init(string dateTime)
主要逻辑实现说明：

1、上个月
获取当月第一天是周几，通过枚举获取索引值
int GetLastMonthDays()
{
string firstWeek = new DateTime(Year, Month, 1).DayOfWeek.ToString();
return (int)Enum.Parse(typeof(DayOfWeek), firstWeek);
}
2、当月
切换日期时，从当月第一天开始，循环当月天数
3、下个月
六行七列，总共42天，减去上个月的天数和这个月的天数，剩下的就是下个月天数
void FillNextMonth()
{
int nextMonthDays = 42 - (lastMonthEmptyDays + days);
if (nextMonthDays != 0)
{
      if (zCalendarModel.autoFillDate)
      {
         DateTime lastDay = monthFirstDay.AddDays(days);
         for (int i = 0; i < nextMonthDays; i++)
         {
               AddDayItem(lastDay.AddDays(i));
         }
      }
   }
}
4、获取时间
通过DateTime中一系列接口获取修改后时间
public DateTime Add(TimeSpan value);
public DateTime AddDays(double value);
public DateTime AddHours(double value);
public DateTime AddMilliseconds(double value);
public DateTime AddMinutes(double value);
public DateTime AddMonths(int months);
public DateTime AddSeconds(double value);
public DateTime AddTicks(long value);
public DateTime AddYears(int value);
农历实现
将当前时间DateTime传入，使用ChineseLunisolarCalendar获取当前农历时间，具体脚本如下：
public System.Globalization.ChineseLunisolarCalendar cncld = new System.Globalization.ChineseLunisolarCalendar();
      /// <summary>
      /// 农历月
      /// </summary>
      public string[] lunarMonths = { &#34;正&#34;, &#34;二&#34;, &#34;三&#34;, &#34;四&#34;, &#34;五&#34;, &#34;六&#34;, &#34;七&#34;, &#34;八&#34;, &#34;九&#34;, &#34;十&#34;, &#34;十一&#34;, &#34;腊&#34; };

      public string[] lunarDaysT = { &#34;初&#34;, &#34;十&#34;, &#34;廿&#34;, &#34;三&#34; };

      /// <summary>
      /// 农历日
      /// </summary>
      public string[] lunarDays = { &#34;一&#34;, &#34;二&#34;, &#34;三&#34;, &#34;四&#34;, &#34;五&#34;, &#34;六&#34;, &#34;七&#34;, &#34;八&#34;, &#34;九&#34;, &#34;十&#34; };
/// <summary>
      /// 显示农历日期
      /// </summary>
      /// <param name=&#34;time&#34;></param>
      void SolarToLunar(DateTime dt)
      {
         int year = cncld.GetYear(dt);
         int flag = cncld.GetLeapMonth(year);
         int month = cncld.GetMonth(dt);
         if (flag > 0)
         {
            if (flag == month)
            {
                  //闰月
                  month--;
            }
            else if (month > flag)
            {
                  month--;
            }
         }
         int day = cncld.GetDayOfMonth(dt);
         lunarTxt.text = (day == 1) ? GetLunarMonth(month) : GetLunarDay(day);
         //Debug.Log($&#34;{year}-{(month.ToString().Length == 1 ? &#34;0&#34; + month : month + &#34;&#34;)}-{(day.ToString().Length == 1 ? &#34;0&#34; + day : day + &#34;&#34;)}&#34;);
      }
      /// <summary>
      /// 获取农历月
      /// </summary>
      /// <param name=&#34;month&#34;></param>
      /// <returns></returns>
      string GetLunarMonth(int month)
      {
         if (month < 13 && month > 0)
         {
            return $&#34;{lunarMonths[month - 1]}月&#34;;
         }
      }
      /// <summary>
      /// 获取农历年
      /// </summary>
      /// <param name=&#34;day&#34;></param>
      /// <returns></returns>
      string GetLunarDay(int day)
      {
         if (day > 0 && day < 32)
         {
            if (day != 20 && day != 30)
            {
                  return string.Concat(lunarDaysT[(day - 1) / 10], lunarDays[(day - 1) % 10]);
            }
            else
            {
                  return string.Concat(lunarDays[(day - 1) / 10], lunarDaysT[1]);
            }
         }
      }

更多好用插件会陆续更新，如有插件优化，或者更多好推荐，烦请大佬们友情指出
组件下载：Jacobkay/unity日历
交流请加企鹅群：747648080
感谢观看~~~~

		自动登录	找回密码
密码			立即注册

Unity日历选择器ZCalendar，使用说明

本帖子中包含更多资源