diff --git a/DateTimePicker.java b/DateTimePicker.java new file mode 100644 index 0000000..3d5e2e0 --- /dev/null +++ b/DateTimePicker.java @@ -0,0 +1,272 @@ +/* + * 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，意味着它可以作为一个容器来承载其他视图组件，并且具备布局相关的特性 +// 这个类主要用于实现一个日期和时间选择的自定义视图组件，方便在Android应用中让用户选择特定的日期和时间 +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）的最大值，设置为一周天数减1，因为索引从0开始 + private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; + // 24小时制视图下小时选择器（NumberPicker）的最小值，范围是0到23小时 + private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; + // 24小时制视图下小时选择器（NumberPicker）的最大值，范围是0到23小时 + private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; + // 12小时制视图下小时选择器（NumberPicker）的最小值，通常从1开始（上午1点） + private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; + // 12小时制视图下小时选择器（NumberPicker）的最大值，到12点结束（中午12点或者晚上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组件，根据设置的是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; + + // 用于存储要在日期选择器中显示的一周七天的字符串表示形式，例如 "周一"、"周二" 等 + private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + + // 用于标记当前时间是上午（true）还是下午（false），在12小时制下使用，初始值根据当前时间判断 + private boolean mIsAm; + + // 用于标记是否处于24小时制视图模式（true表示24小时制，false表示12小时制），决定了小时选择器等相关组件的显示和操作逻辑 + private boolean mIs24HourView; + + // 用于记录整个DateTimePicker组件当前的启用状态，初始化为默认启用状态 + private boolean mIsEnabled = DEFAULT_ENABLE_STATE; + + // 用于标记是否正在初始化组件的过程中，在一些设置逻辑中避免不必要的重复操作或者冲突 + private boolean mInitialising; + + // 定义一个接口类型的成员变量，用于设置当日期和时间发生改变时的回调监听器，外部类可以实现该接口来响应时间日期的变化 + private OnDateTimeChangedListener mOnDateTimeChangedListener; + + // 为日期选择器（mDateSpinner）设置的监听器，当日期选择器的值发生改变时会触发此监听器的onValueChange方法 + // 在此方法中，会根据日期选择器值的变化来更新对应的日期信息，同时通知其他相关组件更新显示，并触发整体的日期时间改变回调（如果有设置） + 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(); + } + }; + + // 为小时选择器（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小时制下，如果当前不是上午且旧值是11（半天的最后一小时），新值变为12（中午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小时制下，如果当前是上午且旧值是12（中午12点），新值变为11（上午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或者从12变为11，意味着上午/下午状态改变 + 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; + } + // 在24小时制下，如果旧值是0（凌晨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; + } + } + // 根据当前是否为24小时制以及上午/下午状态，计算并设置当前的小时数到Calendar对象（mDate）中 + 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)); + } + } + }; + + // 为分钟选择器（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; + // 如果分钟从最大值变为最小值，可能意味着时间跨越了一个小时边界，需要进行相应的时间调整 + if (oldVal == maxValue && newVal == minValue) { + offset += 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(); + if (newHour >= HOURS_IN_HALF_DAY) { + mIsAm = false; + updateAmPmControl(); + } else { + mIsAm = true; + updateAmPmControl(); + } + } + mDate.set(Calendar.MINUTE, newVal); + onDateTimeChanged(); + } + }; + + // 为AM/PM选择器（mAmPmSpinner）设置的监听器，当AM/PM选择器的值发生改变时会触发此监听器的onValueChange方法 + // 此方法中会根据选择的上午/下午变化，相应地调整日期时间中的小时数，并更新相关组件显示，触发日期时间改变回调 + private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + mIsAm =!mIsAm; + 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(); + } + }; + + // 定义一个接口，用于外部类实现，当DateTimePicker中的日期和时间发生改变时，会回调此接口的onDateTimeChanged方法 + // 外部类可以通过实现该接口获取到日期时间变化的具体信息，并进行相应的业务处理，比如更新显示、保存数据等操作 + public interface OnDateTimeChangedListener { + void onDateTimeChanged(DateTimePicker view, int year, int month, + int dayOfMonth, int hourOfDay, int minute); + } + + // 构造方法，调用另一个带有默认当前时间（System.currentTimeMillis()）的构造方法来初始化DateTimePicker组件 + public DateTimePicker(Context context) { + this(context, System.currentTimeMillis()); + } + + // 构造方法，调用另一个带有是否为24小时制参数（DateFormat.is24HourFormat(context)）的构造方法来初始化DateTimePicker组件 + // 传入的参数date用于设置初始的日期时间（以毫秒数表示，通常是从某个时间原点开始的时间戳） + public DateTimePicker(Context context, long date) { + this(context, date, DateFormat.is24HourFormat(context)); + } + + // 主要的构造方法，用于初始化DateTimePicker组件的各个属性、视图组件以及设置初始的日期时间、时间制等相关状态 + public DateTimePicker(Context context, long date, boolean is24HourView) { + super(context); + // 获取一个表示当前时间的Calendar实例，后续用于设置和操作日期时间相关信息 + mDate = Calendar.getInstance(); + mInitialising = true; + // 根据当前小时数判断是上午还是下午（用于初始化12小时制下的初始上午/下午状态） + mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; + // 加载布局文件（R.layout.datetime_picker）到当前的DateTimePicker组件中，该布局文件应该定义了包含日期、时间选择器等相关视图的结构 + 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); + // 设置分钟选择器的最小值和最大值，对应分钟的0到59范围 + mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL); + mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); + // 设置长按更新间隔，这里设置为100毫秒，用于控制长按操作时的数值更新频率（具体根据实际需求和用户体验调整） + mMinuteSpinner.setOnLongPressUpdateInterval(100); + // 为分钟选择器设置值改变监听器，处理分钟值变化的相关逻辑 + mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); + + // 获取用于表示上午（AM）和下午（PM）的字符串数组，用于在AM/PM选择器中显示 + String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings(); + // 获取布局文件中定义的AM/PM选择器（NumberPicker）组件实例 + mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); + // 设置AM/PM选择器的最小值和最大值，对应上午（0）和下午（1）的表示 + mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); + mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); + // 设置AM/PM选择器要显示的字符串值，即上午（AM）和下午（PM）的文本表示 + mAmPmSpinner.setDisplayedValues(stringsForAmPm); + // 为AM/PM选择器设置值改变监听器，处理上午/下午选择变化的相关逻辑 + mAmPm \ No newline at end of file