/* * 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(); } } }