
本文旨在解决android应用中用户选择时间并与当前时间进行比较的常见问题,特别是在处理TimePickerDialog时,如何避免使用旧版Calendar和Time API带来的复杂性和潜在错误。我们将详细介绍如何利用Java 8引入的java.time.LocalTime API,以更简洁、健壮的方式实现时间的选择、初始化和有效性验证,确保用户无法选择已过去的时间。
引入:Android时间选择与比较的挑战
在Android应用开发中,当我们需要让用户选择一个时间(例如预订系统中的预约时间),并确保该时间未早于当前时间时,通常会用到TimePickerDialog。然而,传统的Java日期时间API(如java.util.Calendar和java.util.date,甚至是java.sql.Time)在处理这类场景时存在诸多不便和潜在问题:
- API设计复杂: Calendar的API设计相对繁琐,进行时间计算和比较不够直观。
 - 线程不安全: Calendar和Date都不是线程安全的,可能在多线程环境下引发问题。
 - 时区处理模糊: 默认行为可能依赖于系统默认时区,容易导致跨时区问题。
 - 错误示范: 原始代码中尝试创建new Time(currHour, currMin),这实际上是java.sql.Time,它通常用于数据库操作,并且其构造函数已废弃,其getTimeInMillis()方法返回的是特定日期(1970-01-01)上的时间毫秒数,直接与Calendar.getTimeInMillis()比较可能导致逻辑错误,因为Calendar包含完整的日期信息。
 
这些问题使得开发者在进行简单的“所选时间是否已过去”判断时,不得不编写冗长且易错的代码。
现代解决方案:拥抱 java.time API
自Java 8起,引入了全新的java.time包(也称为JSR-310),它提供了更加强大、清晰且易于使用的日期和时间API。对于仅需要处理一天中的时间(不涉及日期或时区)的场景,java.time.LocalTime是理想的选择。
立即学习“Java免费学习笔记(深入)”;
LocalTime 的核心优势
- 清晰直观: LocalTime表示一天中的时间,例如“10:30”,不包含日期和时区信息,非常适合本场景。
 - 不可变性: LocalTime对象是不可变的,这使得它在多线程环境中是安全的。
 - 链式操作: 提供了丰富的链式方法进行时间操作和比较。
 
使用 LocalTime 进行时间比较
要判断用户选择的时间是否在当前时间之后或相等,我们可以遵循以下步骤:
- 获取当前时间: 使用 LocalTime.now() 获取当前的本地时间。
 - 创建用户选择的时间: 从 TimePickerDialog 的回调中获取 hourOfDay 和 minute,然后使用 LocalTime.of(hour, minute) 创建一个 LocalTime 对象。
 - 进行比较: 使用 isBefore() 方法进行比较。!selectedTime.isBefore(now) 的逻辑表示“selectedTime不早于now”,即selectedTime等于或晚于now。
 
以下是一个简单的Java示例,演示了LocalTime的比较:
import java.time.LocalTime;  public class TimeComparisonDemo {     public static void main(String[] args) {         // 获取当前时间         LocalTime now = LocalTime.now();         System.out.println("当前时间: " + now);          // 假设用户选择了10点20分         int selectedHour = 10;         int selectedMinute = 20;         LocalTime selectedTime = LocalTime.of(selectedHour, selectedMinute);         System.out.println("用户选择时间: " + selectedTime);          // 比较:用户选择的时间是否在当前时间之后或相等         if (!selectedTime.isBefore(now)) {             System.out.println("用户选择的时间有效(在当前时间之后或相等)");         } else {             System.out.println("用户选择的时间已过去(无效)");         }          // 另一个示例:选择一个未来的时间         LocalTime futureTime = LocalTime.of(now.getHour(), now.getMinute()).plusMinutes(1);         System.out.println("未来时间(当前时间+1分钟): " + futureTime);         if (!futureTime.isBefore(now)) {             System.out.println("未来时间有效");         } else {             System.out.println("未来时间无效");         }     } }
在 Android TimePickerDialog 中集成 java.time
现在,我们将上述LocalTime的比较逻辑集成到Android的TimePickerDialog中。
步骤一:确保 java.time 可用
对于Android API级别26(Android 8.0 Oreo)及更高版本,java.time API是直接可用的。 对于更低版本的Android设备,你可以通过在build.gradle文件中启用Java 8+ API desugaring来使用java.time:
android {     // ...     compileOptions {         coreLibraryDesugaringEnabled true         sourceCompatibility JavaVersion.VERSION_1_8         targetCompatibility JavaVersion.VERSION_1_8     } }  dependencies {     coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.5' // 使用最新版本 }
步骤二:初始化 TimePickerDialog
TimePickerDialog的构造函数需要初始的小时和分钟。我们可以继续使用java.util.Calendar来获取当前的系统时间以初始化对话框。
// 获取当前时间用于初始化TimePickerDialog Calendar currentTime = Calendar.getInstance(); int hour = currentTime.get(Calendar.HOUR_OF_DAY); int minute = currentTime.get(Calendar.MINUTE);  TimePickerDialog timePickerDialog = new TimePickerDialog(         MainActivity.this,         new TimePickerDialog.OnTimeSetListener() {             @Override             public void onTimeSet(TimePicker view, int hourOfDay, int minute) {                 // 在这里处理用户选择的时间             }         },         hour, // 初始小时         minute, // 初始分钟         true // 是否使用24小时制,true为24小时制,false为12小时制 ); timePickerDialog.show();
步骤三:在 onTimeSet 回调中进行时间验证
在onTimeSet方法中,获取用户选择的hourOfDay和minute,并结合LocalTime进行有效性验证。
import android.app.TimePickerDialog; import android.os.Bundle; import android.view.View; import android.widget.Button; import android.widget.TimePicker; import android.widget.Toast; import androidx.appcompat.app.AppCompatActivity; import java.time.LocalTime; import java.util.Calendar; // 用于初始化TimePickerDialog public class MainActivity extends AppCompatActivity { private Button selectTimeButton; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 假设布局中有一个ID为selectTimeButton的按钮 selectTimeButton = findViewById(R.id.selectTimeButton); selectTimeButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // 获取当前时间用于初始化TimePickerDialog Calendar currentTime = Calendar.getInstance(); int currentHour = currentTime.get(Calendar.HOUR_OF_DAY); int currentMinute = currentTime.get(Calendar.MINUTE); TimePickerDialog timePickerDialog = new TimePickerDialog( MainActivity.this, new TimePickerDialog.OnTimeSetListener() { @Override public void onTimeSet(TimePicker view, int hourOfDay, int minute) { // 将用户选择的时间转换为LocalTime对象 LocalTime selectedTime = LocalTime.of(hourOfDay, minute); // 获取当前的LocalTime对象(在用户选择时间的那一刻) LocalTime now = LocalTime.now(); // 比较用户选择的时间与当前时间 if (!selectedTime.isBefore(now)) { // 逻辑:selectedTime >= now // 用户选择的时间在当前时间之后或相等,是有效时间 String timeStr = String.format("%02d:%02d", hourOfDay, minute); Toast.makeText(getApplicationContext(), "您选择的时间是:" + timeStr + " (有效)", Toast.LENGTH_LONG).show(); // 在此处执行后续操作,例如保存预订信息、更新UI等 // book.setTime(timeStr); // db.collection("Booking").add(book).addOnSuccesslistener(...); } else { // 用户选择的时间已过去,是无效时间 Toast.makeText(getApplicationContext(), "无效时间:您选择的时间已过去,请重新选择!", Toast.LENGTH_LONG).show(); } } }, currentHour, // 初始小时,设置为当前小时 currentMinute, // 初始分钟,设置为当前分钟 true // 是否使用24小时制。true为24小时制,false为12小时制。 ); timePickerDialog.show(); } }); } }
在上述代码中:
- 我们首先使用Calendar.getInstance()获取当前时间,并用它来初始化TimePickerDialog,确保对话框默认显示当前时间。
 - 在onTimeSet回调中,我们创建了LocalTime selectedTime和LocalTime now。now是在用户点击“确定”按钮那一刻获取的当前时间,这保证了比较的实时性。
 - !selectedTime.isBefore(now)简洁地表达了“所选时间不早于当前时间”的逻辑,即所选时间在当前时间之后或与当前时间相等。
 
注意事项与总结
- Android版本兼容性: 务必根据你的项目需求,正确配置desugar_jdk_libs以支持旧版Android设备上的java.time API。
 - 时区: LocalTime不包含时区信息。如果你的应用需要处理跨时区的预约或时间显示,你可能需要使用ZonedDateTime或OffsetTime等更高级的java.time类型。但对于仅仅比较一天中的时间是否已过去,LocalTime是足够且最合适的。
 - 用户体验: 及时向用户反馈时间选择是否有效,如Toast消息所示,有助于提升用户体验。
 - 后续操作: 在时间验证通过后,再执行保存数据(如Firebase数据库操作)或其他业务逻辑,避免无效操作。
 
通过采纳java.time API,我们可以显著提高Android应用中时间处理代码的清晰度、健壮性和可维护性,告别传统API带来的诸多困扰。