|
|
|
|
@ -0,0 +1,321 @@
|
|
|
|
|
/*
|
|
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
|
|
*
|
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
|
*
|
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
*
|
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
|
* limitations under the License.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
|
|
|
|
import java.text.DateFormatSymbols;
|
|
|
|
|
import java.util.Calendar;
|
|
|
|
|
|
|
|
|
|
import net.micode.notes.R;
|
|
|
|
|
|
|
|
|
|
import android.content.Context;
|
|
|
|
|
import android.text.format.DateFormat;
|
|
|
|
|
import android.view.View;
|
|
|
|
|
import android.widget.FrameLayout;
|
|
|
|
|
import android.widget.NumberPicker;
|
|
|
|
|
|
|
|
|
|
// DateTimePicker类继承自FrameLayout，它是一个自定义的视图组件，用于展示日期和时间选择的交互界面，
|
|
|
|
|
// 支持24小时制和12小时制（含AM/PM标识），用户可以通过该组件方便地选择具体的日期和时间，并能响应相应的变化事件。
|
|
|
|
|
public class DateTimePicker extends FrameLayout {
|
|
|
|
|
|
|
|
|
|
// 定义默认的启用状态，默认为启用，即组件默认是可以交互操作的
|
|
|
|
|
private static final boolean DEFAULT_ENABLE_STATE = true;
|
|
|
|
|
|
|
|
|
|
// 一天中半天（12小时制）包含的小时数
|
|
|
|
|
private static final int HOURS_IN_HALF_DAY = 12;
|
|
|
|
|
// 一天（24小时制）包含的小时数
|
|
|
|
|
private static final int HOURS_IN_ALL_DAY = 24;
|
|
|
|
|
// 一周包含的天数
|
|
|
|
|
private static final int DAYS_IN_ALL_WEEK = 7;
|
|
|
|
|
// 日期选择器（NumberPicker）的最小值，通常对应一周的第一天（索引从0开始）
|
|
|
|
|
private static final int DATE_SPINNER_MIN_VAL = 0;
|
|
|
|
|
// 日期选择器（NumberPicker）的最大值，对应一周的最后一天（一周共7天，索引从0到6）
|
|
|
|
|
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
|
|
|
|
|
// 24小时制视图下小时选择器（NumberPicker）的最小值，即0时
|
|
|
|
|
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
|
|
|
|
|
// 24小时制视图下小时选择器（NumberPicker）的最大值，即23时
|
|
|
|
|
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
|
|
|
|
|
// 12小时制视图下小时选择器（NumberPicker）的最小值，通常为1时（习惯上12小时制从1开始计数）
|
|
|
|
|
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
|
|
|
|
|
// 12小时制视图下小时选择器（NumberPicker）的最大值，即12时
|
|
|
|
|
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
|
|
|
|
|
// 分钟选择器（NumberPicker）的最小值，即0分
|
|
|
|
|
private static final int MINUT_SPINNER_MIN_VAL = 0;
|
|
|
|
|
// 分钟选择器（NumberPicker）的最大值，即59分
|
|
|
|
|
private static final int MINUT_SPINNER_MAX_VAL = 59;
|
|
|
|
|
// AM/PM选择器（NumberPicker）的最小值，对应AM（通常用0表示）
|
|
|
|
|
private static final int AMPM_SPINNER_MIN_VAL = 0;
|
|
|
|
|
// AM/PM选择器（NumberPicker）的最大值，对应PM（通常用1表示）
|
|
|
|
|
private static final int AMPM_SPINNER_MAX_VAL = 1;
|
|
|
|
|
|
|
|
|
|
// 用于显示日期的NumberPicker组件，用户可通过它选择具体的日期（以周为范围展示）
|
|
|
|
|
private final NumberPicker mDateSpinner;
|
|
|
|
|
// 用于显示小时的NumberPicker组件，根据设置的视图模式（24小时制或12小时制）展示不同范围的小时值
|
|
|
|
|
private final NumberPicker mHourSpinner;
|
|
|
|
|
// 用于显示分钟的NumberPicker组件，可选择0到59分钟
|
|
|
|
|
private final NumberPicker mMinuteSpinner;
|
|
|
|
|
// 用于显示AM/PM的NumberPicker组件，仅在12小时制下可见且用于切换上午或下午标识
|
|
|
|
|
private final NumberPicker mAmPmSpinner;
|
|
|
|
|
|
|
|
|
|
// 用于存储和操作当前选择的日期和时间信息，基于Calendar类实现，方便进行日期和时间的计算与设置
|
|
|
|
|
private Calendar mDate;
|
|
|
|
|
|
|
|
|
|
// 用于存储一周内各天要展示给用户的显示值（例如格式化后的"MM.dd EEEE"格式的字符串）
|
|
|
|
|
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
|
|
|
|
|
|
|
|
|
|
// 用于标识当前时间是上午（true）还是下午（false），在12小时制下使用
|
|
|
|
|
private boolean mIsAm;
|
|
|
|
|
|
|
|
|
|
// 用于标识当前是否处于24小时制视图模式，true表示24小时制，false表示12小时制
|
|
|
|
|
private boolean mIs24HourView;
|
|
|
|
|
|
|
|
|
|
// 用于存储组件当前的启用状态，初始化为默认启用状态
|
|
|
|
|
private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
|
|
|
|
|
|
|
|
|
|
// 用于标记是否处于初始化阶段，在初始化过程中某些逻辑可能会有不同处理，避免不必要的重复操作等
|
|
|
|
|
private boolean mInitialising;
|
|
|
|
|
|
|
|
|
|
// 定义一个接口类型的成员变量，用于设置当日期和时间发生变化时的回调监听器，外部类可以实现该接口来响应变化事件
|
|
|
|
|
private OnDateTimeChangedListener mOnDateTimeChangedListener;
|
|
|
|
|
|
|
|
|
|
// 内部类实现的日期选择器（NumberPicker）的值变化监听器，当用户在日期选择器上选择不同日期时触发
|
|
|
|
|
private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
|
|
@Override
|
|
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
|
|
// 根据新选择的日期与旧日期的差值，调整Calendar对象中的日期（增加或减少相应天数）
|
|
|
|
|
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
|
|
|
|
|
// 更新日期相关的显示控制，例如刷新显示的日期字符串等
|
|
|
|
|
updateDateControl();
|
|
|
|
|
// 触发日期和时间变化的回调方法，通知外部可能关注此变化的地方进行相应处理
|
|
|
|
|
onDateTimeChanged();
|
|
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
// 内部类实现的小时选择器（NumberPicker）的值变化监听器，当用户在小时选择器上选择不同小时时触发
|
|
|
|
|
private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
|
|
@Override
|
|
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
|
|
boolean isDateChanged = false;
|
|
|
|
|
Calendar cal = Calendar.getInstance();
|
|
|
|
|
if (!mIs24HourView) {
|
|
|
|
|
// 在12小时制下，如果从上午11时切换到下午12时（中午），意味着日期需要增加一天
|
|
|
|
|
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
|
|
|
|
|
cal.setTimeInMillis(mDate.getTimeInMillis());
|
|
|
|
|
cal.add(Calendar.DAY_OF_YEAR, 1);
|
|
|
|
|
isDateChanged = true;
|
|
|
|
|
}
|
|
|
|
|
// 反之，从下午12时（中午）切换到上午11时，日期需要减少一天
|
|
|
|
|
else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
|
|
|
|
|
cal.setTimeInMillis(mDate.getTimeInMillis());
|
|
|
|
|
cal.add(Calendar.DAY_OF_YEAR, -1);
|
|
|
|
|
isDateChanged = true;
|
|
|
|
|
}
|
|
|
|
|
// 如果是上午11时与下午12时（中午）之间切换，还需要更新AM/PM标识并刷新相关显示控制
|
|
|
|
|
if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
|
|
|
|
|
oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
|
|
|
|
|
mIsAm =!mIsAm;
|
|
|
|
|
updateAmPmControl();
|
|
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
// 在24小时制下，如果从23时切换到0时，日期需要增加一天
|
|
|
|
|
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
|
|
|
|
|
cal.setTimeInMillis(mDate.getTimeInMillis());
|
|
|
|
|
cal.add(Calendar.DAY_OF_YEAR, 1);
|
|
|
|
|
isDateChanged = true;
|
|
|
|
|
}
|
|
|
|
|
// 反之，从0时切换到23时，日期需要减少一天
|
|
|
|
|
else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
|
|
|
|
|
cal.setTimeInMillis(mDate.getTimeInMillis());
|
|
|
|
|
cal.add(Calendar.DAY_OF_YEAR, -1);
|
|
|
|
|
isDateChanged = true;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
// 根据当前选择的小时（考虑12小时制与24小时制转换情况），设置Calendar对象中的小时信息
|
|
|
|
|
int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm? 0 : HOURS_IN_HALF_DAY);
|
|
|
|
|
mDate.set(Calendar.HOUR_OF_DAY, newHour);
|
|
|
|
|
// 触发日期和时间变化的回调方法，通知外部进行相应处理
|
|
|
|
|
onDateTimeChanged();
|
|
|
|
|
// 如果日期发生了变化，更新年份、月份和日期的显示信息
|
|
|
|
|
if (isDateChanged) {
|
|
|
|
|
setCurrentYear(cal.get(Calendar.YEAR));
|
|
|
|
|
setCurrentMonth(cal.get(Calendar.MONTH));
|
|
|
|
|
setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
// 内部类实现的分钟选择器（NumberPicker）的值变化监听器，当用户在分钟选择器上选择不同分钟时触发
|
|
|
|
|
private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
|
|
@Override
|
|
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
|
|
int minValue = mMinuteSpinner.getMinValue();
|
|
|
|
|
int maxValue = mMinuteSpinner.getMaxValue();
|
|
|
|
|
int offset = 0;
|
|
|
|
|
// 如果从最大分钟值（59分）切换到最小分钟值（0分），意味着小时需要增加1小时（时间进位）
|
|
|
|
|
if (oldVal == maxValue && newVal == minValue) {
|
|
|
|
|
offset += 1;
|
|
|
|
|
}
|
|
|
|
|
// 反之，从最小分钟值切换到最大分钟值，小时需要减少1小时（时间退位）
|
|
|
|
|
else if (oldVal == minValue && newVal == maxValue) {
|
|
|
|
|
offset -= 1;
|
|
|
|
|
}
|
|
|
|
|
if (offset!= 0) {
|
|
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, offset);
|
|
|
|
|
mHourSpinner.setValue(getCurrentHour());
|
|
|
|
|
updateDateControl();
|
|
|
|
|
int newHour = getCurrentHourOfDay();
|
|
|
|
|
// 根据新的小时值判断是否切换AM/PM标识，并更新相关显示控制（仅在12小时制下相关）
|
|
|
|
|
if (newHour >= HOURS_IN_HALF_DAY) {
|
|
|
|
|
mIsAm = false;
|
|
|
|
|
updateAmPmControl();
|
|
|
|
|
} else {
|
|
|
|
|
mIsAm = true;
|
|
|
|
|
updateAmPmControl();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
mDate.set(Calendar.MINUTE, newVal);
|
|
|
|
|
onDateTimeChanged();
|
|
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
// 内部类实现的AM/PM选择器（NumberPicker）的值变化监听器，当用户在AM/PM选择器上切换时触发
|
|
|
|
|
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
|
|
@Override
|
|
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
|
|
mIsAm =!mIsAm;
|
|
|
|
|
// 根据切换后的AM/PM标识，相应地调整Calendar对象中的小时信息（增加或减少12小时）
|
|
|
|
|
if (mIsAm) {
|
|
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
|
|
|
|
|
} else {
|
|
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
|
|
|
|
|
}
|
|
|
|
|
updateAmPmControl();
|
|
|
|
|
onDateTimeChanged();
|
|
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
// 定义一个接口，用于外部类实现，以便在日期和时间发生变化时接收通知并进行相应处理
|
|
|
|
|
public interface OnDateTimeChangedListener {
|
|
|
|
|
void onDateTimeChanged(DateTimePicker view, int year, int month,
|
|
|
|
|
int dayOfMonth, int hourOfDay, int minute);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 构造函数，使用当前系统时间作为默认时间初始化DateTimePicker组件，默认根据系统设置判断是否采用24小时制视图
|
|
|
|
|
public DateTimePicker(Context context) {
|
|
|
|
|
this(context, System.currentTimeMillis());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 构造函数，使用指定的时间（以毫秒为单位的时间戳）初始化DateTimePicker组件，默认根据系统设置判断是否采用24小时制视图
|
|
|
|
|
public DateTimePicker(Context context, long date) {
|
|
|
|
|
this(context, date, DateFormat.is24HourFormat(context));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 完整的构造函数，用于初始化DateTimePicker组件，传入上下文、指定的时间以及是否采用24小时制视图的标识
|
|
|
|
|
public DateTimePicker(Context context, long date, boolean is24HourView) {
|
|
|
|
|
super(context);
|
|
|
|
|
// 获取一个Calendar实例，用于存储和操作日期时间信息，初始化为当前时间（如果没有传入指定时间的话）
|
|
|
|
|
mDate = Calendar.getInstance();
|
|
|
|
|
mInitialising = true;
|
|
|
|
|
// 根据当前小时数判断是上午还是下午（用于初始化AM/PM标识，仅在12小时制下相关）
|
|
|
|
|
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
|
|
|
|
|
// 加载布局文件到该组件中，布局文件中应该包含了各个NumberPicker组件等用于展示和交互的视图元素
|
|
|
|
|
inflate(context, R.layout.datetime_picker, this);
|
|
|
|
|
|
|
|
|
|
// 获取布局文件中定义的日期选择器（NumberPicker）组件，并进行相关初始化设置
|
|
|
|
|
mDateSpinner = (NumberPicker) findViewById(R.id.date);
|
|
|
|
|
mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
|
|
|
|
|
mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
|
|
|
|
|
mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
|
|
|
|
|
|
|
|
|
|
// 获取小时选择器（NumberPicker）组件，并设置其值变化监听器
|
|
|
|
|
mHourSpinner = (NumberPicker) findViewById(R.id.hour);
|
|
|
|
|
mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
|
|
|
|
|
|
|
|
|
|
// 获取分钟选择器（NumberPicker）组件，设置其最小值、最大值以及长按更新间隔等属性，并设置值变化监听器
|
|
|
|
|
mMinuteSpinner = (NumberPicker) findViewById(R.id.minute);
|
|
|
|
|
mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
|
|
|
|
|
mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
|
|
|
|
|
mMinuteSpinner.setOnLongPressUpdateInterval(100);
|
|
|
|
|
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
|
|
|
|
|
|
|
|
|
|
// 获取用于显示AM/PM的NumberPicker组件，设置其最小值、最大值，并设置显示的字符串值（从DateFormatSymbols获取AM/PM标识字符串），再设置其值变化监听器
|
|
|
|
|
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
|
|
|
|
|
mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
|
|
|
|
|
mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
|
|
|
|
|
mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL);
|
|
|
|
|
mAmPmSpinner.setDisplayedValues(stringsForAmPm);
|
|
|
|
|
mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
|
|
|
|
|
|
|
|
|
|
// 调用相关方法更新各个控件的初始显示状态，使其展示正确的初始日期、时间以及相关格式等信息
|
|
|
|
|
updateDateControl();
|
|
|
|
|
updateHourControl();
|
|
|
|
|
updateAmPmControl();
|
|
|
|
|
|
|
|
|
|
// 根据传入的参数设置是否采用24小时制视图模式，并相应更新控件显示
|
|
|
|
|
set24HourView(is24HourView);
|
|
|
|
|
|
|
|
|
|
// 设置当前日期时间为传入的指定时间（如果有传入的话），或者保持默认的当前时间
|
|
|
|
|
setCurrentDate(date);
|
|
|
|
|
|
|
|
|
|
// 设置组件的初始启用状态
|
|
|
|
|
setEnabled(isEnabled());
|
|
|
|
|
|
|
|
|
|
// 初始化完成，将初始化标记设置为false，后续操作不再按照初始化阶段处理
|
|
|
|
|
mInitialising = false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 重写父类的setEnabled方法，用于设置组件及其包含的各个子控件（NumberPicker组件）的启用状态，同时更新内部的启用状态记录变量
|
|
|
|
|
@Override
|
|
|
|
|
public void setEnabled(boolean enabled) {
|
|
|
|
|
if (mIsEnabled == enabled) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
super.setEnabled(enabled);
|
|
|
|
|
mDateSpinner.setEnabled(enabled);
|
|
|
|
|
mMinuteSpinner.setEnabled(enabled);
|
|
|
|
|
mHourSpinner.setEnabled(enabled);
|
|
|
|
|
mAmPmSpinner.setEnabled(enabled);
|
|
|
|
|
mIsEnabled = enabled;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 重写父类的isEnabled方法，返回组件当前的启用状态
|
|
|
|
|
@Override
|
|
|
|
|
public boolean isEnabled() {
|
|
|
|
|
return mIsEnabled;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 获取当前日期对应的时间戳（以毫秒为单位），通过Calendar对象获取其内部存储的时间信息并返回
|
|
|
|
|
*
|
|
|
|
|
* @return the current date in millis（当前日期的毫秒时间戳）
|
|
|
|
|
*/
|
|
|
|
|
public long getCurrentDateInTimeMillis() {
|
|
|
|
|
return mDate.getTimeInMillis();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 设置当前日期，传入以毫秒为单位的时间戳，内部会解析并设置对应的年、月、日、时、分等信息到Calendar对象中
|
|
|
|
|
*
|
|
|
|
|
* @param date The current date in millis（要设置的日期的毫秒时间戳）
|
|
|
|
|
*/
|
|
|
|
|
public void setCurrentDate(long date) {
|
|
|
|
|
Calendar cal = Calendar.getInstance();
|
|
|
|
|
cal.setTimeInMillis(date);
|
|
|
|
|
setCurrentDate(cal.get();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
