DatePickerRange 日期范围选择框

DatePickerRange 用于选择开始日期与结束日期，例如报表区间、筛选时间段、有效期等。

最小示例

import win.ui;
import dotNet.AntdUI;
/*DSG{{*/
var winform = win.form(text="AntdUI DatePickerRange";right=460;bottom=170)
winform.add(
host={cls="custom";left=0;top=0;right=460;bottom=41;edge=1;z=1}
)
/*}}*/

var range = AntdUI.DatePickerRange(winform.host);
range.Format = "yyyy-MM-dd";
range.PlaceholderStart = "开始日期";
range.PlaceholderEnd = "结束日期";
range.AllowClear = true;
range.DropDownArrow = true;
range.ValueChanged = function(sender,e){
    winform.text = "日期范围已改变";
}

winform.show();
win.loopMessage();

常用属性与事件

• Value：日期数组，通常包含开始与结束两个 System.DateTime。
• Format：日期格式，例如 yyyy-MM-dd。
• MinDate、MaxDate：可选日期范围。
• PlaceholderStart、PlaceholderEnd：起止日期占位文本。
• AllowClear：允许清除。
• ShowIcon、DropDownArrow：显示图标/箭头。
• Placement：弹出位置。
• Presets：预设范围集合。
• ValueChanged、PresetsClickChanged：日期范围/预设点击事件。

主动设置日期范围

Value 是 .NET System.DateTime[]，数组索引是 0 基。可用 System.Array.CreateInstance(System.DateTime,2) 创建开始/结束日期数组：

import System;

var arr = System.Array.CreateInstance(System.DateTime,2);
arr.SetValue(System.DateTime(2026,7,1),0);
arr.SetValue(System.DateTime(2026,7,31),1);
range.Value = arr;

读取时也使用 0 基索引：

var startDate = range.Value.GetValue(0);
var endDate = range.Value.GetValue(1);

注意事项

• Value 是 .NET DateTime[]，从 aardio 主动赋值时可用 System.Array.CreateInstance(System.DateTime,2) 构造。
• DatePickerRange 是独立的日期范围选择控件，不是 DatePicker 的简单组合；AntdUI 2.4.1 中 DatePicker / Calendar 支持 ShowButtonToDay，但 DatePickerRange 的公开属性列表没有此属性。范围快捷选择可用外部按钮或 Presets 实现。
• Clear() 可清空当前范围；ClearClick 可响应用户点击清除按钮；ExpandDropChanged 可监听下拉面板展开/关闭。
• 只选单个日期时使用 DatePicker。
• 完整组合场景可参考：日期时间筛选与预约面板。

Markdown 格式