今天分享一個日曆選擇控件，可以定義日期可選、選擇範圍、按月分組展示。這個日曆無非就是把每個日期的數據通過系統的日曆查詢出來，然後用recyclerview展示即可，數據模型裏可以定義哪些可選以及選定狀態等等。思路就是這樣了，先看看效果：
首先定義好數據來源，即從系統的calendar獲取日期列表，這裏因爲是要按月分組，所以我選擇用一個key爲月份的時間戳value爲對應月份的所有日期list的map來接收查詢出來的日曆，在展示的時候把map轉爲分組的list即可：
import android.annotation.SuppressLint;
import androidx.annotation.NonNull;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Calendar;
import java.util.Date;
import java.util.LinkedHashMap;
/**
* 日曆工具類
* @author ly
* date 2020/4/24 9:52
*/
public class CalendarUtils {
public final static String YEAR = "yyyy";
public final static String YEAR_MONTH = "yyyy年MM月";
public final static String MONTH_DAY = "MM-dd";
public final static String DATE = "yyyy-MM-dd";
public final static String TIME = "HH:mm";
public final static String MONTH_DAY_TIME = "MM月dd日 hh:mm";
public final static String DATE_TIME_SECOND = "yyyy-MM-dd HH:mm:ss";
public final static String DATE_TIME = "yyyy-MM-dd HH:mm";
public final static String DATE1_TIME = "yyyy/MM/dd HH:mm";
public static @NonNull
LinkedHashMap<Long, ArrayList<DateInfo>> getMonthMap(Calendar initialCalendar, int monthNum) {
return getMonthMap(initialCalendar, monthNum, Integer.MAX_VALUE);
}
public static @NonNull
LinkedHashMap<Long, ArrayList<DateInfo>> getMonthByLimit(Calendar initialCalendar, int validSelNumLimit) {
return getMonthMap(initialCalendar, Integer.MAX_VALUE, validSelNumLimit);
}
/**
* 以月爲單位，獲取每個月的日期列表
*
* @param initialCalendar 初始選中的日期
* @param validSelNumLimit 最大有效選中數量
* @return 返回一個key爲當前loop月的時間戳，value爲當前月的所有日期list的有序map
* @author ly on 2020/4/25 11:37
*/
public static @NonNull
LinkedHashMap<Long, ArrayList<DateInfo>> getMonthMap(Calendar initialCalendar, int monthNum, int validSelNumLimit) {
//key：當前loop月的時間戳 value：當前月的所有日期list
LinkedHashMap<Long, ArrayList<DateInfo>> dateMap = new LinkedHashMap<>();
ArrayList<DateInfo> dateInMonthList = new ArrayList<>();
if (initialCalendar == null)
initialCalendar = Calendar.getInstance();
Calendar c = Calendar.getInstance();
//設置開始遍歷的date
//也可以不使用下面的set，直接c.setTime(initialCalendar.getTime())，只是第一個月的數據可能不足那個月的最大天數（ui不美觀）
//告訴calendar從指定月的第一天開始，而不是精確到某一天
c.set(initialCalendar.get(Calendar.YEAR), initialCalendar.get(Calendar.MONTH), 1);
int loopMonthCount = 0;
int validDateNum = 0;//有效的可選日期數量
while (loopMonthCount < monthNum) {
// 獲取當前月最大天數
int maxDayNum = c.getActualMaximum(Calendar.DATE);
int month = c.get(Calendar.MONTH);
DateInfo dateInfo = new DateInfo();
dateInfo.year = c.get(Calendar.YEAR);
dateInfo.month = month + 1;
dateInfo.day = c.get(Calendar.DAY_OF_MONTH);
dateInfo.timestamp = c.getTimeInMillis();
dateInfo.week = c.get(Calendar.DAY_OF_WEEK);
dateInfo.isSelected = initialCalendar.get(Calendar.MONTH) == c.get(Calendar.MONTH) && initialCalendar.get(Calendar.DATE) == c.get(Calendar.DATE);
//是否爲可選的日期
boolean isAvailableDate = (dateInfo.isSelected || c.after(initialCalendar)) && dateInfo.week != Calendar.SUNDAY && dateInfo.week != Calendar.SATURDAY;
if (isAvailableDate)
validDateNum++;
dateInfo.canSelect = isAvailableDate && validDateNum <= validSelNumLimit;
if (dateInMonthList.isEmpty()) {//在每一月的第一週前面補空data
for (int j = 0; j < dateInfo.week - 1; j++) {
DateInfo d = new DateInfo();
dateInMonthList.add(0, d);
}
}
dateInMonthList.add(dateInfo);
if (maxDayNum == dateInfo.day) {//每loop到月底put一次
dateMap.put(dateInfo.timestamp, new ArrayList<>(dateInMonthList));
dateInMonthList.clear();
if (validDateNum < validSelNumLimit) {
loopMonthCount++;
} else {
break;//達到最大可選數後自動跳出looper
}
}
//條件滿足時一直add天數即可
c.add(Calendar.DATE, 1);
}
return dateMap;
}
public static @NonNull
LinkedHashMap<Long, ArrayList<DateInfo>> getMonthMap(String startDate, String endDate) {
//key：當前loop月的時間戳 value：當前月的所有日期list
LinkedHashMap<Long, ArrayList<DateInfo>> dateMap = new LinkedHashMap<>();
ArrayList<DateInfo> dateInMonthList = new ArrayList<>();
long startTimestamp = getMillisecondByFormat(startDate, DATE);
long endTimestamp = getMillisecondByFormat(endDate, DATE);
if (endTimestamp < startTimestamp || startTimestamp <= 0)
return dateMap;
Calendar start = Calendar.getInstance();
start.setTimeInMillis(startTimestamp);
Calendar end = Calendar.getInstance();
end.setTimeInMillis(endTimestamp);
Calendar c = Calendar.getInstance();
//設置開始遍歷的date
//也可以不使用下面的set，直接c.setTime(initialCalendar.getTime())，只是第一個月的數據可能不足那個月的最大天數（ui不美觀）
//告訴calendar從指定月的第一天開始，而不是精確到某一天
c.set(start.get(Calendar.YEAR), start.get(Calendar.MONTH), 1);
boolean needLoop = true;
while (needLoop) {
// 獲取當前月最大天數
int maxDayNum = c.getActualMaximum(Calendar.DATE);
int month = c.get(Calendar.MONTH);
DateInfo dateInfo = new DateInfo();
dateInfo.year = c.get(Calendar.YEAR);
dateInfo.month = month;
dateInfo.day = c.get(Calendar.DAY_OF_MONTH);
dateInfo.timestamp = c.getTimeInMillis();
dateInfo.week = c.get(Calendar.DAY_OF_WEEK);
//此處理想條件應爲 start.getTimeInMillis()==c.getTimeInMillis()，但開始時間戳和查詢出來的時間戳不相等（就算是同一天）
//先用這個判斷着
dateInfo.isSelected = start.get(Calendar.YEAR) == c.get(Calendar.YEAR) && start.get(Calendar.MONTH) == c.get(Calendar.MONTH) && start.get(Calendar.DATE) == c.get(Calendar.DATE);
boolean isEnd = end.get(Calendar.MONTH) == c.get(Calendar.MONTH) && end.get(Calendar.DATE) == c.get(Calendar.DATE);
dateInfo.canSelect = (dateInfo.isSelected || c.after(start)) && (c.before(end) || isEnd) && dateInfo.week != Calendar.SUNDAY && dateInfo.week != Calendar.SATURDAY;
if (dateInMonthList.isEmpty()) {//在每一月的第一週前面補空data
for (int j = 0; j < dateInfo.week - 1; j++) {
DateInfo d = new DateInfo();
dateInMonthList.add(0, d);
}
}
dateInMonthList.add(dateInfo);
if (maxDayNum == dateInfo.day) {//每loop到月底put一次
dateMap.put(dateInfo.timestamp, new ArrayList<>(dateInMonthList));
dateInMonthList.clear();
needLoop = c.before(end);//每到月底判斷一下，是否還需繼續loop
}
//條件滿足時一直add天數即可
c.add(Calendar.DATE, 1);
}
return dateMap;
}
/**
* 獲取當前日期一週的日期
*/
@SuppressLint("SimpleDateFormat")
public static ArrayList<DateInfo> getWeek(String date) {
ArrayList<DateInfo> result = new ArrayList<>();
Calendar c = Calendar.getInstance();
try {
c.setTime(new SimpleDateFormat("yyyy-MM-dd").parse(date));
} catch (ParseException e) {
e.printStackTrace();
}
c.set(Calendar.DAY_OF_WEEK, Calendar.SUNDAY); //獲取本週一的日期
for (int i = 0; i < 7; i++) {
DateInfo entity = new DateInfo();
entity.timestamp = c.getTimeInMillis();
entity.day = c.get(Calendar.DATE);
entity.week = c.get(Calendar.DAY_OF_WEEK);
c.add(Calendar.DATE, 1);
result.add(entity);
}
return result;
}
/**
* 獲取系統當前日期
*/
public static String getCurrDate(String format) {
@SuppressLint("SimpleDateFormat") SimpleDateFormat formatter = new SimpleDateFormat(format);
Date curDate = new Date(System.currentTimeMillis());//獲取當前時間
return formatter.format(curDate);
}
/**
* String類型的日期時間轉化爲毫秒（1970-）類型.
*
* @param strDate String形式的日期時間
* @param format 格式化字符串，如："yyyy-MM-dd HH:mm:ss"
* @author LY 2015-9-16 上午11:40:26
*/
public static long getMillisecondByFormat(String strDate, String format) {
@SuppressLint("SimpleDateFormat") SimpleDateFormat mSimpleDateFormat = new SimpleDateFormat(format);
Date date = null;
try {
date = mSimpleDateFormat.parse(strDate);
} catch (ParseException e) {
e.printStackTrace();
}
if (date == null) return 0;
return date.getTime();
}
/**
* 毫秒----> format格式的日期
*
* @author LY 2015-9-18 下午3:41:32
*/
public static String getDateByMillisecond(long milliseconds, String format) {
Date d = new Date(milliseconds);
@SuppressLint("SimpleDateFormat") SimpleDateFormat f = new SimpleDateFormat(format);
return f.format(d);
}
public static String getCurDateByFormat(String format) {
return getDateByMillisecond(System.currentTimeMillis(), format);
}
public static String getNextMonthByFormat(String format) {
Calendar c = Calendar.getInstance();
c.setTimeInMillis(System.currentTimeMillis());
c.add(Calendar.MONTH, 1);
Date d = c.getTime();
@SuppressLint("SimpleDateFormat") SimpleDateFormat f = new SimpleDateFormat(format);
return f.format(d);
}
}
日曆的數據entity，注意一下canSelect我這裏的業務需求是週末不可選，其他在範圍內的日期可選，可以根據自己的需求來定製。DateInfo：
import com.robot.common.utils.CalendarUtils;
import java.util.Calendar;
/**
* @author ly
* date 2020/4/24 9:52
*/
public class DateInfo {
public long timestamp; //時間戳
public int year;
public int month;
public int day;
public int week;//一週中第幾天，非中式
//是否選中
public boolean isSelected;
//日期是否可選
public boolean canSelect;
/**
* 根據美式週末到週一 返回
*/
public String getWeekName() {
String name = "";
switch (week) {
case Calendar.SUNDAY:
name = "週日";
break;
case Calendar.MONDAY:
name = "週一";
break;
case Calendar.TUESDAY:
name = "週二";
break;
case Calendar.WEDNESDAY:
name = "週三";
break;
case Calendar.THURSDAY:
name = "週四";
break;
case Calendar.FRIDAY:
name = "週五";
break;
case Calendar.SATURDAY:
name = "週六";
break;
default:
break;
}
return name;
}
public String getDay() {
if (day > 0) {
return String.valueOf(day);
} else {
return "";
}
}
public int getMonth() {
return month + 1;
}
public String getDate() {
return CalendarUtils.getDateByMillisecond(timestamp, CalendarUtils.DATE);
}
}
最後就是負責展示的類了，很簡單。這裏是dialog來實現的：
import android.app.Activity;
import android.view.Gravity;
import android.view.ViewGroup;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.GridLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import com.chad.library.adapter.base.BaseSectionQuickAdapter;
import com.chad.library.adapter.base.BaseViewHolder;
import com.chad.library.adapter.base.entity.SectionEntity;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
/**
* @author ly
* date 2019/8/1 17:36
*/
public class SelDateDialog extends BaseDialog {
private SectionAdapter mAdapter;
private OnDateSelectedListener onDateSelectedListener;
private List<DateSection> dateList = new ArrayList<>();
private LinkedHashMap<Long, ArrayList<DateInfo>> monthMap;
private RecyclerView rv;
private int selPosition;
private DateInfo selDateInfo;
public SelDateDialog(@NonNull Activity activity, OnDateSelectedListener onDateSelectedListener) {
super(activity);
this.onDateSelectedListener = onDateSelectedListener;
mAdapter = new SectionAdapter(dateList);
mAdapter.setOnItemClickListener((adapter, view, position) -> {
SectionEntity<DateInfo> item = mAdapter.getItem(position);
if (item == null || item.t == null)//item.t=null可能是點到了header 不做處理
return;
selPosition = position;
mAdapter.selectOne(position);
selDateInfo = item.t;
if (onDateSelectedListener != null) {
onDateSelectedListener.onDateSelect(selDateInfo);
}
// dismiss();
});
}
@Override
public int getLayoutResId() {
return R.layout.dialog_sel_date;
}
@Override
public void initViews() {
if (getWindow() != null) {
getWindow().getAttributes().width = ScreenUtil.getScreenWidth();
getWindow().getAttributes().height = (int) (ScreenUtil.getScreenHeight() * 0.7);
getWindow().setGravity(Gravity.BOTTOM);
getWindow().setWindowAnimations(com.robot.common.R.style.bottom_enter_anim);
}
setCanceledOnTouchOutside(true);
setCancelable(true);
findViewById(R.id.m_tv_dialog_sel_date_cancel).setOnClickListener(view -> {
dismiss();
});
rv = findViewById(R.id.m_rv_dialog_calendar);
rv.setLayoutManager(new GridLayoutManager(getContext(), 7));
mAdapter.bindToRecyclerView(rv);
rv.smoothScrollToPosition(selPosition);
}
public void setData(String startDate, String endDate) {
if (!dateList.isEmpty()) {
dateList.clear();
mAdapter.notifyDataSetChanged();
}
// LinkedHashMap<Long, ArrayList<DateInfo>> month = CalendarUtils.getMonthByLimit(selCalendar, 30);
monthMap = CalendarUtils.getMonthMap(startDate, endDate);
for (Long aLong : monthMap.keySet()) {
DateSection sectionTitle = new DateSection(true, CalendarUtils.getDateByMillisecond(aLong, CalendarUtils.YEAR_MONTH));
dateList.add(sectionTitle);
ArrayList<DateInfo> monthDateList = monthMap.get(aLong);
if (monthDateList != null)
for (DateInfo dateInfo : monthDateList) {
dateList.add(new DateSection(dateInfo));
if (dateInfo.isSelected) {
selDateInfo = dateInfo;
if (onDateSelectedListener != null)
onDateSelectedListener.onDateSelect(selDateInfo);
}
}
}
DateSection sectionFooter = new DateSection(true, "後續日期暫不可訂");
dateList.add(sectionFooter);
}
public LinkedHashMap<Long, ArrayList<DateInfo>> getMonthMap() {
return monthMap;
}
public DateInfo getSelDateInfo() {
return selDateInfo;
}
public void selectOne(DateInfo dateInfo) {
if (dateInfo != null && dateList != null) {
for (int i = 0; i < dateList.size(); i++) {
DateSection dateSection = dateList.get(i);
DateInfo info = dateSection.t;
if (info != null) {
info.isSelected = dateInfo.timestamp == info.timestamp;
if (info.isSelected)
selPosition = i;
}
}
mAdapter.notifyDataSetChanged();
if (rv != null)
rv.smoothScrollToPosition(selPosition);
}
}
static class SectionAdapter extends BaseSectionQuickAdapter<DateSection, BaseViewHolder> {
private int itemW;
SectionAdapter(List<DateSection> data) {
super(R.layout.dialog_sel_date_item, R.layout.dialog_sel_date_title, data);
itemW = ScreenUtil.getScreenWidth() / 7;
}
void selectOne(int position) {
for (int i = 0; i < mData.size(); i++) {
SectionEntity<DateInfo> entity = mData.get(i);
DateInfo dateInfo = entity.t;
if (dateInfo != null)
dateInfo.isSelected = position == i;
}
notifyDataSetChanged();
}
@Override
protected void convertHead(BaseViewHolder helper, final DateSection item) {
helper.setText(R.id.m_tv_dialog_sel_date_title, item.header);
}
@Override
protected void convert(BaseViewHolder helper, DateSection item) {
DateInfo dateInfo = item.t;
TextView tv = helper.getView(R.id.m_tv_dialog_sel_date);
tv.setText(dateInfo.getDay());
helper.itemView.setEnabled(dateInfo.canSelect);
tv.setBackgroundResource(dateInfo.isSelected ? R.mipmap.ic_date_item_sel : R.color.transparent);
if (dateInfo.canSelect) {
if (dateInfo.isSelected) {
tv.setTextColor(0xffffffff);
} else {
tv.setTextColor(mContext.getResources().getColor(R.color.black_text1));
}
} else {
tv.setTextColor(0xffC3C3DC);
}
ViewGroup.LayoutParams layoutParams = helper.itemView.getLayoutParams();
layoutParams.width = itemW;
layoutParams.height = itemW;
}
}
private static class DateSection extends SectionEntity<DateInfo> {
DateSection(boolean isHeader, String header) {
super(isHeader, header);
}
DateSection(DateInfo dateInfo) {
super(dateInfo);
}
}
public interface OnDateSelectedListener {
void onDateSelect(@NonNull DateInfo dateInfo);
}
}
注：recyclerview的adapter使用了BaseRecyclerViewAdapterHelper
佈局也貼一下，dialog_sel_date：
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/ll_dialog_share_confirm"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="bottom"
android:background="@drawable/shape_white_tr16b0"
android:gravity="bottom"
android:orientation="vertical">
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal">
<ImageView
android:id="@+id/m_tv_dialog_sel_date_cancel"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:padding="@dimen/list_lr_margin"
android:src="@mipmap/ic_close"
android:text="取消" />
<com.robot.common.view.BoldTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:gravity="center"
android:text="選擇日期"
android:textColor="#ff282832"
android:textSize="17sp" />
</RelativeLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="8dp"
android:paddingBottom="15dp">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="日"
android:textColor="#fffa496a"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="一"
android:textColor="@color/black_text1"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="二"
android:textColor="@color/black_text1"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="三"
android:textColor="@color/black_text1"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="四"
android:textColor="@color/black_text1"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="五"
android:textColor="@color/black_text1"
android:textSize="12sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="center"
android:text="六"
android:textColor="#fffa496a"
android:textSize="12sp" />
</LinearLayout>
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/m_rv_dialog_calendar"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1"
android:overScrollMode="never"
tools:listitem="@layout/m_dialog_item_sel_scenic" />
</LinearLayout>
dialog_sel_date_item:
<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/m_tv_dialog_sel_date"
style="@style/text_black"
android:layout_gravity="center"
android:gravity="center"
android:textSize="16sp"
tools:text="10" />
m_tv_dialog_sel_date_title:
<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/m_tv_dialog_sel_date_title"
style="@style/text_black"
android:layout_width="match_parent"
android:background="#F3F3FA"
android:gravity="center"
android:paddingTop="6dp"
android:paddingBottom="6dp"
android:textSize="14sp"
tools:text="2020.3"/>
接着在需要用這個日曆的地方創建上面的Dialog，傳入開始及結束日期show即可：
SelDateDialog selDateDialog = new SelDateDialog(this, dateInfo -> showToast(dateInfo.getDate()));
selDateDialog.setData("2020-07-06", "2020-08-06");
selDateDialog.show();
最後，我想說一下，github上有很多的開源日曆庫，那些庫大多功能繁多，如果app對日曆依賴性強，需求稍微複雜那我還是建議用開源庫的，畢竟不用花時間造輪子。但是簡單的需求（就如本例）就沒必要用那些庫了，而且還要看文檔學他的使用方式，還不如自己動手寫了。所以視情況而定，不要動不動就接第三方庫，不利於自己能力的提升。