From ebb40b70f481776ad7808e50c7d890530e77196d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BE=90=E5=8B=A4=E6=B0=91?= <xuqinmin@bjca.org.cn>
Date: Wed, 6 Nov 2024 20:19:55 +0800
Subject: [PATCH] =?UTF-8?q?feat(basic):=20=E6=96=B0=E5=A2=9E=E6=97=A5?=
 =?UTF-8?q?=E6=9C=9F=E9=80=89=E6=8B=A9=E5=B7=A5=E5=85=B7=20PickerDateTimeH?=
 =?UTF-8?q?elper?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加 PickerDateTimeHelper 类，提供日期选择功能
- 在 CHANGELOG.md 和 README.md 中更新相关文档
-定义 DateDialogOptions 接口，支持自定义日期选择器的配置
- 实现 showDateDialog 静态方法，用于显示日期选择器
---
 CHANGELOG.md                                |  1 +
 README.md                                   | 17 +++++++++++++++++
 src/main/ets/utils/PickerDateTimeHelper.ets | 13 +++++++++++--
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8745567..73ff1a9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@
 > - 网络工具优化
 > - 新增下拉刷新和加载更多组件
 > - ToolsHelper优化
+> - 新增日期选择工具PickerDateTimeHelper
 > - 其它优化，可自行探索
 >
 
diff --git a/README.md b/README.md
index 7d14bda..8d4c5d9 100644
--- a/README.md
+++ b/README.md
@@ -144,6 +144,23 @@ XWebHelper.openWeb({
 })
 ```
 
+### 1.7.[PickerDateTimeHelper](./src/main/ets/utils/PickerDateTimeHelper.ets)
+
+> 时间日期选择弹窗相关
+>
+
+#### 1.7.1 选择日期
+
+```typescript
+import { PickerDateTimeHelper } from '@szyx/sdk_base'
+
+PickerDateTimeHelper.showDateDialog({
+  onConfirm: (date) => {
+    ToolsHelper.log(date)
+  }
+}, this)
+```
+
 ## 2.[Dialog](./src/main/ets/dialog)
 
 ### 2.1.弹出list选中弹窗
diff --git a/src/main/ets/utils/PickerDateTimeHelper.ets b/src/main/ets/utils/PickerDateTimeHelper.ets
index 4ce5508..522f51b 100644
--- a/src/main/ets/utils/PickerDateTimeHelper.ets
+++ b/src/main/ets/utils/PickerDateTimeHelper.ets
@@ -2,12 +2,17 @@ import { DatePickerView } from './compose/DatePickerView'
 import { ToolsHelper } from './ToolsHelper'
 
 export interface DateDialogOptions {
-  // 'YYYY-MM-DD'年月日对应的标识，随意组合
+  // 'YYYY-MM-DD'年月日对应的标识，随意组合，默认YYYY-MM-DD
   type?: string
+  // 可选择的开始日期，默认1970-1-1
   startDate?: string
+  // 可选择的结束日期，默认当前月最后一天
   endDate?: string
+  // 当前选中的日期，默认当前日期
   currentDate?: string
+  // 选择器确定按钮点击事件
   onConfirm: (date: string) => void
+  // 选择器取消按钮点击事件
   onCancel?: () => void
 }
 
@@ -25,7 +30,11 @@ export class PickerDateTimeHelper {
   private constructor() {
   }
 
-
+  /**
+   * 显示日期选择器
+   * @param options
+   * @param p 调用页面直接this
+   */
   static showDateDialog(options: DateDialogOptions, p: object) {
     const dialogTag = ToolsHelper.getUuid()
     ToolsHelper.showCustomDialog(dialogTag, dateDialogBuilder.bind(p, options, dialogTag),