From 6c18ae98a033d2caa6b1ef54a59915d7c2a013ee Mon Sep 17 00:00:00 2001
From: pfmsx5cbu <1807616406@qq.com>
Date: Mon, 16 Jun 2025 23:57:33 +0800
Subject: [PATCH] Update DateTimePickerDialog.java

---
 .../micode/notes/ui/DateTimePickerDialog.java | 67 ++++++++++++++-----
 1 file changed, 52 insertions(+), 15 deletions(-)

diff --git a/java/net/micode/notes/ui/DateTimePickerDialog.java b/java/net/micode/notes/ui/DateTimePickerDialog.java
index 2c47ba4..f3f64c2 100644
--- a/java/net/micode/notes/ui/DateTimePickerDialog.java
+++ b/java/net/micode/notes/ui/DateTimePickerDialog.java
@@ -29,59 +29,96 @@ import android.content.DialogInterface.OnClickListener;
 import android.text.format.DateFormat;
 import android.text.format.DateUtils;
 
+/**
+ * 日期时间选择对话框，继承自AlertDialog
+ * 提供日期和时间选择功能，并允许用户确认或取消选择
+ */
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
 
-    private Calendar mDate = Calendar.getInstance();
-    private boolean mIs24HourView;
-    private OnDateTimeSetListener mOnDateTimeSetListener;
-    private DateTimePicker mDateTimePicker;
+    private Calendar mDate = Calendar.getInstance();// 存储当前选择的日期时间
+    private boolean mIs24HourView;// 是否使用24小时制
+    private OnDateTimeSetListener mOnDateTimeSetListener;// 日期时间设置回调接口
+    private DateTimePicker mDateTimePicker; // 日期时间选择器视图
 
+    /**
+     * 日期时间设置回调接口
+     */
     public interface OnDateTimeSetListener {
         void OnDateTimeSet(AlertDialog dialog, long date);
     }
 
+    /**
+     * 构造函数
+     * @param context 上下文
+     * @param date 初始日期时间(毫秒时间戳)
+     */
     public DateTimePickerDialog(Context context, long date) {
         super(context);
+        // 初始化日期时间选择器
         mDateTimePicker = new DateTimePicker(context);
-        setView(mDateTimePicker);
+        setView(mDateTimePicker);// 将选择器添加到对话框
+        // 设置日期时间变化监听器
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+                // 更新当前选择的日期时间
                 mDate.set(Calendar.YEAR, year);
                 mDate.set(Calendar.MONTH, month);
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
                 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
                 mDate.set(Calendar.MINUTE, minute);
+                // 更新对话框标题显示
                 updateTitle(mDate.getTimeInMillis());
             }
         });
+        // 设置初始日期时间
         mDate.setTimeInMillis(date);
-        mDate.set(Calendar.SECOND, 0);
+        mDate.set(Calendar.SECOND, 0);// 秒数设为0
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
-        setButton(context.getString(R.string.datetime_dialog_ok), this);
-        setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
-        set24HourView(DateFormat.is24HourFormat(this.getContext()));
-        updateTitle(mDate.getTimeInMillis());
+        // 设置对话框按钮
+        setButton(context.getString(R.string.datetime_dialog_ok), this);// 确定按钮
+        setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);//取消按钮
+        set24HourView(DateFormat.is24HourFormat(this.getContext())); // 根据系统设置决定是否使用24小时制
+        updateTitle(mDate.getTimeInMillis());// 初始化对话框标题
     }
 
+     /**
+     * 设置是否使用24小时制显示时间
+     * @param is24HourView true表示使用24小时制，false表示12小时制
+     */
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
 
+    /**
+     * 设置日期时间设置回调监听器
+     * @param callBack 回调接口实现
+     */
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
         mOnDateTimeSetListener = callBack;
     }
 
+    /**
+     * 更新对话框标题显示
+     * @param date 当前日期时间(毫秒时间戳)
+     */
     private void updateTitle(long date) {
+        // 设置日期时间显示格式
         int flag =
-            DateUtils.FORMAT_SHOW_YEAR |
-            DateUtils.FORMAT_SHOW_DATE |
-            DateUtils.FORMAT_SHOW_TIME;
-        flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
-        setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
+            DateUtils.FORMAT_SHOW_YEAR |//显示年份
+            DateUtils.FORMAT_SHOW_DATE |//显示日期
+            DateUtils.FORMAT_SHOW_TIME;//显示时间
+        flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;// 根据设置添加24小时制或12小时制标志
+        setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));// 格式化日期时间并设置为对话框标题
     }
 
+     /**
+     * 对话框按钮点击事件处理
+     * @param arg0 对话框接口
+     * @param arg1 按钮ID
+     */
     public void onClick(DialogInterface arg0, int arg1) {
+         // 当用户点击确定按钮时，调用回调接口
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }