|
|
/*
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// 包声明，表明该类所在的包名为net.micode.notes.ui
|
|
|
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，它是一个自定义的视图组件，用于实现日期和时间的选择功能，用户可以通过该组件方便地设置年、月、日、时、分以及选择12/24小时制等。
|
|
|
public class DateTimePicker extends FrameLayout {
|
|
|
|
|
|
// 定义默认的启用状态，默认为启用（true），用于控制整个DateTimePicker组件及其内部子控件的可交互状态。
|
|
|
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天，最大值为6（索引从0开始）。
|
|
|
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）的最小值，通常为0（对应AM）。
|
|
|
private static final int AMPM_SPINNER_MIN_VAL = 0;
|
|
|
// 定义上午/下午（AM/PM）选择器（NumberPicker）的最大值，通常为1（对应PM）。
|
|
|
private static final int AMPM_SPINNER_MAX_VAL = 1;
|
|
|
|
|
|
// 用于显示日期的NumberPicker控件，用户可以通过它选择具体的日期（以一周内的某一天来表示）。
|
|
|
private final NumberPicker mDateSpinner;
|
|
|
// 用于显示小时的NumberPicker控件，根据设置的12/24小时制，显示相应范围的小时选项供用户选择。
|
|
|
private final NumberPicker mHourSpinner;
|
|
|
// 用于显示分钟的NumberPicker控件，提供0到59分钟的选项供用户选择。
|
|
|
private final NumberPicker mMinuteSpinner;
|
|
|
// 用于显示上午/下午（AM/PM）的NumberPicker控件，在12小时制下用于区分时间段，仅在非24小时制时可见。
|
|
|
private final NumberPicker mAmPmSpinner;
|
|
|
// Calendar对象，用于存储和操作当前选择的日期和时间信息，方便进行各种日期时间的计算和设置。
|
|
|
private Calendar mDate;
|
|
|
|
|
|
// 用于存储一周内各天显示名称的字符串数组，例如“周一”“周二”等，会根据系统设置进行本地化显示。
|
|
|
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
|
|
|
|
|
|
// 用于标记当前时间是否处于上午（AM），根据小时数等情况进行更新，用于12小时制下的显示和逻辑判断。
|
|
|
private boolean mIsAm;
|
|
|
|
|
|
// 用于标记是否处于24小时制视图，true表示24小时制，false表示12小时制，决定了小时选择器和上午/下午选择器的显示及相关逻辑。
|
|
|
private boolean mIs24HourView;
|
|
|
|
|
|
// 用于存储组件的启用状态，初始化为默认的启用状态，通过相应方法可以修改并控制组件及其内部控件的可操作性。
|
|
|
private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
|
|
|
|
|
|
// 用于标记是否处于初始化阶段，在初始化过程中一些逻辑处理可能与正常使用阶段有所不同，避免不必要的重复操作或异常情况。
|
|
|
private boolean mInitialising;
|
|
|
|
|
|
// 定义一个接口类型的变量，用于设置日期时间改变时的回调监听器，外部类可以实现该接口来监听用户在DateTimePicker上操作导致的日期时间变化情况。
|
|
|
private OnDateTimeChangedListener mOnDateTimeChangedListener;
|
|
|
|
|
|
// 内部类，实现了NumberPicker.OnValueChangeListener接口，用于监听日期选择器（mDateSpinner）的值变化事件。
|
|
|
// 当用户在日期选择器上选择了不同的日期时，会触发该监听器的onValueChange方法，进而更新内部的日期信息（mDate）以及相关的显示控件，并通知外部监听器日期时间已改变。
|
|
|
private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
@Override
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
// 根据新选择的日期与旧日期的差值，调整内部的Calendar对象（mDate）的日期信息，实现日期的变更。
|
|
|
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
|
|
|
// 更新日期显示相关的控件，确保界面上显示的日期信息是最新的。
|
|
|
updateDateControl();
|
|
|
// 调用onDateTimeChanged方法，通知外部监听器日期时间已发生改变，触发相应的回调逻辑（如果有设置监听器的话）。
|
|
|
onDateTimeChanged();
|
|
|
}
|
|
|
};
|
|
|
|
|
|
// 内部类，实现了NumberPicker.OnValueChangeListener接口，用于监听小时选择器（mHourSpinner）的值变化事件。
|
|
|
// 当用户在小时选择器上选择了不同的小时值时，会触发该监听器的onValueChange方法，根据12/24小时制等不同情况进行日期、时间以及相关显示控件的更新，并通知外部监听器日期时间已改变。
|
|
|
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小时制下，如果当前是下午（!mIsAm）且从11点（HOURS_IN_HALF_DAY - 1）切换到12点（HOURS_IN_HALF_DAY），则日期需要加一天，标记日期已改变。
|
|
|
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小时制下，如果当前是上午（mIsAm）且从12点（HOURS_IN_HALF_DAY）切换到11点（HOURS_IN_HALF_DAY - 1），则日期需要减一天，标记日期已改变。
|
|
|
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点或者从12点切换到11点，还需要切换上午/下午（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点（HOURS_IN_ALL_DAY - 1）切换到0点，则日期需要加一天，标记日期已改变。
|
|
|
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
|
|
|
cal.setTimeInMillis(mDate.getTimeInMillis());
|
|
|
cal.add(Calendar.DAY_OF_YEAR, 1);
|
|
|
isDateChanged = true;
|
|
|
}
|
|
|
// 在24小时制下，如果从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小时制下），计算出用于设置到内部Calendar对象（mDate）的小时数，并进行设置。
|
|
|
int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm? 0 : HOURS_IN_HALF_DAY);
|
|
|
mDate.set(Calendar.HOUR_OF_DAY, newHour);
|
|
|
// 通知外部监听器日期时间已发生改变，触发相应的回调逻辑（如果有设置监听器的话）。
|
|
|
onDateTimeChanged();
|
|
|
// 如果日期发生了改变，更新当前的年、月、日信息到组件内部的Calendar对象（mDate）中，确保整体日期时间信息的一致性。
|
|
|
if (isDateChanged) {
|
|
|
setCurrentYear(cal.get(Calendar.YEAR));
|
|
|
setCurrentMonth(cal.get(Calendar.MONTH));
|
|
|
setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
|
|
|
}
|
|
|
}
|
|
|
};
|
|
|
|
|
|
// 内部类，实现了NumberPicker.OnValueChangeListener接口，用于监听分钟选择器（mMinuteSpinner）的值变化事件。
|
|
|
// 当用户在分钟选择器上选择了不同的分钟值时，会触发该监听器的onValueChange方法，根据分钟值的变化情况进行日期、时间以及相关显示控件的更新，并通知外部监听器日期时间已改变。
|
|
|
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;
|
|
|
}
|
|
|
// 如果从最小分钟值（0）切换到最大分钟值（59），则小时数需要减1，表示时间向前推移了一小时。
|
|
|
else if (oldVal == minValue && newVal == maxValue) {
|
|
|
offset -= 1;
|
|
|
}
|
|
|
if (offset!= 0) {
|
|
|
// 根据分钟值变化导致的小时数偏移，调整内部的Calendar对象（mDate）的小时信息，实现时间的变更。
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, offset);
|
|
|
// 更新小时选择器的值，使其显示与内部时间一致的小时数。
|
|
|
mHourSpinner.setValue(getCurrentHour());
|
|
|
// 更新日期显示相关的控件，确保界面上显示的日期信息是最新的，因为时间变更可能跨越了一天的边界。
|
|
|
updateDateControl();
|
|
|
int newHour = getCurrentHourOfDay();
|
|
|
// 根据更新后的小时数，判断是否处于上午或下午，更新上午/下午的标记，并相应地更新显示控件。
|
|
|
if (newHour >= HOURS_IN_HALF_DAY) {
|
|
|
mIsAm = false;
|
|
|
updateAmPmControl();
|
|
|
} else {
|
|
|
mIsAm = true;
|
|
|
updateAmPmControl();
|
|
|
}
|
|
|
}
|
|
|
// 设置内部的Calendar对象（mDate）的分钟信息为用户选择的新分钟值。
|
|
|
mDate.set(Calendar.MINUTE, newVal);
|
|
|
// 通知外部监听器日期时间已发生改变，触发相应的回调逻辑（如果有设置监听器的话）。
|
|
|
onDateTimeChanged();
|
|
|
}
|
|
|
};
|
|
|
|
|
|
// 内部类，实现了NumberPicker.OnValueChangeListener接口，用于监听上午/下午（AM/PM）选择器（mAmPmSpinner）的值变化事件。
|
|
|
// 当用户在上午/下午选择器上切换了选项时，会触发该监听器的onValueChange方法，相应地调整内部的日期时间信息以及更新相关显示控件，并通知外部监听器日期时间已改变。
|
|
|
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
|
|
|
@Override
|
|
|
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
|
|
|
mIsAm =!mIsAm;
|
|
|
// 如果切换到上午（AM），则将小时数减去12小时（从下午时间转换到上午时间对应的小时调整）。
|
|
|
if (mIsAm) {
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
|
|
|
}
|
|
|
// 如果切换到下午（PM），则将小时数加上12小时（从上午时间转换到下午时间对应的小时调整）。
|
|
|
else {
|
|
|
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
|
|
|
}
|
|
|
// 更新上午/下午显示相关的控件，确保界面上显示的信息与内部状态一致。
|
|
|
updateAmPmControl();
|
|
|
// 通知外部监听器日期时间已发生改变，触发相应的回调逻辑（如果有设置监听器的话）。
|
|
|
onDateTimeChanged();
|
|
|
}
|
|
|
};
|
|
|
|
|
|
// 定义一个接口，用于外部类实现，以便在DateTimePicker的日期时间发生改变时接收到通知并进行相应的处理。
|
|
|
public interface OnDateTimeChangedListener {
|
|
|
void onDateTimeChanged(DateTimePicker view, int year, int month,
|
|
|
int dayOfMonth, int hourOfDay, int minute);
|
|
|
}
|
|
|
|
|
|
// 构造函数，创建一个DateTimePicker实例，使用当前系统时间作为初始时间进行初始化。
|
|
|
public DateTimePicker(Context context) {
|
|
|
this(context, System.currentTimeMillis());
|
|
|
}
|
|
|
|
|
|
// 构造函数，创建一个DateTimePicker实例，并使用指定的日期时间（以毫秒为单位的时间戳）作为初始时间进行初始化。
|
|
|
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），用于初始化上午/下午标记（如果当前小时大于等于12，则为下午，即!mIsAm）。
|
|
|
mIsAm = getCurrentHourOfDay() >= HOURS |
