feat(DateTimePicker): support customize disabled date

src/BootstrapBlazor.Server/Components/Samples/DateTimePickers.razor

@@ -34,7 +34,7 @@
             <Pre>builder.Services.AddBootstrapHolidayService();</Pre>
         </div>
     </section>
-    <DatePickerBody @bind-Value="Value" OnConfirm="@NormalOnConfirm" ShowFooter="false" ShowLunar="_showLunar" ShowSolarTerm="_showSolarTerm" ShowFestivals="_showFestivals" ShowHolidays="_showHolidays" />
+    <DatePickerBody @bind-Value="Value" OnConfirm="@NormalOnConfirm" ShowFooter="false" ShowLunar="_showLunar" ShowSolarTerm="_showSolarTerm" ShowFestivals="_showFestivals" ShowHolidays="_showHolidays"/>
     <ConsoleLogger @ref="NormalLogger" class="mt-3" />
     <section ignore>
         <Tips class="mt-3">
@@ -188,6 +188,29 @@
     </DateTimePicker>
 </DemoBlock>
 
+<DemoBlock Title="@Localizer["DisableDayPredicateTitle"]" Introduction="@Localizer["DisableDayPredicateIntro"]" Name="DisableDayPredicate">
+    <section ignore>
+        <GroupBox Title="@Localizer["DisableOptions"]">
+            <div class="row g-3 form-inline text-end">
+                <div class="col-12 col-sm-3">
+                    <Switch DisplayText="@Localizer["DisableSunday"]" ShowLabel="true" @bind-Value="_disableSunday" />
+                </div>
+                <div class="col-12 col-sm-3">
+                    <Switch DisplayText="@Localizer["DisableToday"]" ShowLabel="true" @bind-Value="_disableToday" />
+                </div>
+            </div>
+        </GroupBox>
+    </section>
+    <DateTimePicker ViewMode="DatePickerViewMode.DateTime" @bind-Value="@BindNullValue" DisableDayPredicate="(day) => _disableSunday && day.DayOfWeek == DayOfWeek.Sunday || (_disableToday && day.Date == DateTime.Today)">
+        <TimePickerSetting ShowClockScale="true" IsAutoSwitch="false" />
+    </DateTimePicker>
+     <section ignore>
+        <Tips class="mt-3">
+            <p>@((MarkupString)Localizer["DisableDayPredicateTip"].Value)</p>
+        </Tips>
+    </section>
+</DemoBlock>
+
 <AttributeTable Items="@GetAttributes()" />
 
 <EventTable Items="@GetEvents()" />

src/BootstrapBlazor.Server/Components/Samples/DateTimePickers.razor.cs

@@ -90,6 +90,8 @@ private string BindValueString
     private bool _showSolarTerm = true;
     private bool _showFestivals = true;
     private bool _showHolidays = true;
+    private bool _disableSunday = true;
+    private bool _disableToday = false;
 
     /// <summary>
     /// 获得事件方法

src/BootstrapBlazor.Server/Locales/en-US.json

@@ -2556,7 +2556,13 @@
     "FeatureShowFestivals": "Festivals",
     "FeatureShowHolidays": "Holidays",
     "FeatureIntro": "<b>Holidays</b> Functional dependency component packages <code>BootstrapBlazor.Holiday</code> <a href=\"holiday\" target=\"_blank\">[Portal]</a>",
-    "FeatureFestivalIntro": "<b>The festival</b> function is provided by the built-in service <code>ICalendarFestivals</code> in the component library. The built-in default implementation provides 12 Gregorian festivals and 7 lunar festivals, which can be extended through custom festival services. For detailed function introductions, please refer to the <b>Festival Services</b> documentation <a href=\"festival\" target=\"_blank\">[Portal]</a>"
+    "FeatureFestivalIntro": "<b>The festival</b> function is provided by the built-in service <code>ICalendarFestivals</code> in the component library. The built-in default implementation provides 12 Gregorian festivals and 7 lunar festivals, which can be extended through custom festival services. For detailed function introductions, please refer to the <b>Festival Services</b> documentation <a href=\"festival\" target=\"_blank\">[Portal]</a>",
+    "DisableOptions": "Disable options",
+    "DisableSunday": "Disable sunday",
+    "DisableToday": "Disable today",
+    "DisableDayPredicateTitle": "Customize the disable date",
+    "DisableDayPredicateIntro": "Specify which dates are disabled by setting <code>DisableDayPredicate</code>",
+    "DisableDayPredicateTip": "Please note that you must set the allowed empty time for the custom disable date to take effect. When the binding value is determined to be disabled, the binding value will be reset to empty time!"
   },
   "BootstrapBlazor.Server.Components.Samples.TimePickers": {
     "Title": "TimePicker",

src/BootstrapBlazor.Server/Locales/zh-CN.json

@@ -2556,7 +2556,13 @@
     "FeatureShowFestivals": "节日",
     "FeatureShowHolidays": "法定假日",
     "FeatureIntro": "<b>假日</b>功能依赖组件包 <code>BootstrapBlazor.Holiday</code> <a href=\"holiday\" target=\"_blank\">[传送门]</a>",
-    "FeatureFestivalIntro": "<b>节日</b>功能由组件库内置服务 <code>ICalendarFestivals</code> 提供，内置默认实现提供了 12 个公历节日与 7 个农历节日，可以通过自定义节日服务进行扩展，详细功能介绍请参阅 <b>节日服务</b> 文档 <a href=\"festival\" target=\"_blank\">[传送门]</a>"
+    "FeatureFestivalIntro": "<b>节日</b>功能由组件库内置服务 <code>ICalendarFestivals</code> 提供，内置默认实现提供了 12 个公历节日与 7 个农历节日，可以通过自定义节日服务进行扩展，详细功能介绍请参阅 <b>节日服务</b> 文档 <a href=\"festival\" target=\"_blank\">[传送门]</a>",
+    "DisableOptions": "禁用选项",
+    "DisableSunday": "禁用周日",
+    "DisableToday": "禁用今天",
+    "DisableDayPredicateTitle": "自定义禁用日期",
+    "DisableDayPredicateIntro": "通过设置 <code>DisableDayPredicate</code> 自定义哪些日期需要被禁用",
+    "DisableDayPredicateTip": "请注意，必须要设置允许空时间，自定义禁用日期才会生效，当绑定值被判断为禁用时，绑定值将被重置为空时间！"
   },
   "BootstrapBlazor.Server.Components.Samples.TimePickers": {
     "Title": "TimePicker 时间选择器",

src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor

@@ -80,12 +80,12 @@
                                                 else if (IsDisabled(day))
                                                 {
                                                     <span class="cell">
-                                                        @if(ShowLunar)
+                                                        @if (ShowLunar)
                                                         {
                                                             <span>@text</span>
                                                             <span class="bb-picker-body-lunar-text">@GetLunarText(day)</span>
                                                         }
-                                                        else if(DayDisabledTemplate != null)
+                                                        else if (DayDisabledTemplate != null)
                                                         {
                                                             @DayDisabledTemplate(day)
                                                         }
@@ -175,7 +175,7 @@
                     </Button>
                 }
             </div>
-            @if (MinValue == null && MaxValue == null)
+            @if (!IsDisabled(DateTime.Today))
             {
                 <Button class="picker-panel-link-btn is-now" Color="Color.None" OnClickWithoutRender="@ClickNowButton">
                     <span>@NowButtonText</span>

src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor.cs

@@ -73,7 +73,7 @@ private DateTime StartDate
         .AddClass("is-open", ShowTimePicker)
         .Build();
 
-    private bool IsDisabled(DateTime day) => (MinValue.HasValue && day < MinValue.Value) || (MaxValue.HasValue && day > MaxValue.Value);
+    private bool IsDisabled(DateTime day) => (MinValue.HasValue && day < MinValue.Value) || (MaxValue.HasValue && day > MaxValue.Value) || (DisableDayPredicate != null && DisableDayPredicate(day));
 
     /// <summary>
     /// 获得 上一月按钮样式
@@ -375,6 +375,12 @@ public bool AllowNull
     [CascadingParameter]
     private DateTimeRange? Ranger { get; set; }
 
+    /// <summary>
+    /// 获取/设置 自定义禁用日期判断方法
+    /// </summary>
+    [Parameter]
+    public Func<DateTime, bool>? DisableDayPredicate { get; set; }
+
     [Inject]
     [NotNull]
     private ICalendarFestivals? CalendarFestivals { get; set; }
@@ -770,7 +776,7 @@ private void ResetTimePickerPanel()
         TimePickerPanel?.Reset();
     }
 
-    private bool Validate() => (!MinValue.HasValue || SelectValue >= MinValue.Value) && (!MaxValue.HasValue || SelectValue <= MaxValue.Value);
+    private bool Validate() => !IsDisabled(SelectValue);
 
     /// <summary>
     /// 

src/BootstrapBlazor/Components/DateTimePicker/DateTimePicker.razor

@@ -17,7 +17,7 @@
                     DateTimeFormat="@DateTimeFormat" DateFormat="@DateFormat" TimeFormat="@TimeFormat" ShowFooter="true"
                     ShowLunar="ShowLunar" ShowSolarTerm="ShowSolarTerm" ShowFestivals="ShowFestivals" ShowHolidays="ShowHolidays"
                     OnConfirm="OnConfirm" OnClear="OnClear" MinValue="MinValue" MaxValue="MaxValue"
-                    AutoClose="AutoClose" ViewMode="ViewMode" DayTemplate="DayTemplate!" DayDisabledTemplate="DayDisabledTemplate!">
+                    AutoClose="AutoClose" ViewMode="ViewMode" DayTemplate="DayTemplate!" DayDisabledTemplate="DayDisabledTemplate!" DisableDayPredicate="ReliableDisableDayPredicate!">
         @ChildContent
     </DatePickerBody>
 </div>

src/BootstrapBlazor/Components/DateTimePicker/DateTimePicker.razor.cs

@@ -209,6 +209,12 @@ public string? Format
     [Parameter]
     public bool ShowHolidays { get; set; }
 
+    /// <summary>
+    /// 获取/设置 自定义禁用日期判断方法 (注意：仅当允许空时间时此方法才会生效)
+    /// </summary>
+    [Parameter]
+    public Func<DateTime, bool>? DisableDayPredicate { get; set; }
+
     [Inject]
     [NotNull]
     private IStringLocalizer<DateTimePicker<DateTime>>? Localizer { get; set; }
@@ -222,6 +228,8 @@ public string? Format
 
     private DateTime SelectedValue { get; set; }
 
+    private Func<DateTime, bool>? ReliableDisableDayPredicate { get; set; }
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
@@ -249,6 +257,11 @@ protected override void OnParametersSet()
 
         Icon ??= IconTheme.GetIconByKey(ComponentIcons.DateTimePickerIcon);
 
+        if (AllowNull && DisableDayPredicate != null)
+        {
+            ReliableDisableDayPredicate = DisableDayPredicate;
+        }
+
         var type = typeof(TValue);
 
         // 判断泛型类型
@@ -257,25 +270,34 @@ protected override void OnParametersSet()
             throw new InvalidOperationException(GenericTypeErrorMessage);
         }
 
-        // Value 为 MinValue 时 设置 Value 默认值
         if (Value == null)
         {
             SelectedValue = DateTime.MinValue;
         }
         else if (Value is DateTimeOffset v1)
         {
-            SelectedValue = v1.DateTime;
+            SelectedValue = ViewMode == DatePickerViewMode.DateTime ? v1.DateTime : v1.DateTime.Date;
         }
         else
         {
-            SelectedValue = (DateTime)(object)Value;
+            SelectedValue = ViewMode == DatePickerViewMode.DateTime ? (DateTime)(object)Value : ((DateTime)(object)Value).Date;
         }
 
-        if (MinValueToEmpty(SelectedValue))
+        if (ReliableDisableDayPredicate != null && ReliableDisableDayPredicate(SelectedValue))
         {
-            SelectedValue = DateTime.Today;
+            SelectedValue = ViewMode == DatePickerViewMode.DateTime ? DateTime.Now : DateTime.Today;
             Value = default;
         }
+        else if (MinValueToEmpty(SelectedValue))
+        {
+            SelectedValue = ViewMode == DatePickerViewMode.DateTime ? DateTime.Now : DateTime.Today;
+            Value = default;
+        }
+        else if (MinValue.HasValue && MinValue > DateTime.Today)
+        {
+            SelectedValue = ViewMode == DatePickerViewMode.DateTime ? MinValue.Value : MinValue.Value.Date;
+            Value = GetValue();
+        }
         else if (MinValueToToday(SelectedValue))
         {
             SelectedValue = ViewMode == DatePickerViewMode.DateTime ? DateTime.Now : DateTime.Today;
@@ -377,4 +399,13 @@ protected override bool TryParseValueFromString(string value, [MaybeNullWhen(fal
     }
 
     private string? ReadonlyString => IsEditable ? null : "readonly";
+
+    private Func<DateTime, bool>? GetSafeDisableDayPredicate()
+    {
+        if (!AllowNull || AutoToday)
+        {
+            return null;
+        }
+        return DisableDayPredicate;
+    }
 }

test/UnitTest/Components/DateTimePickerTest.cs

@@ -1017,6 +1017,43 @@ await cut.InvokeAsync(() =>
         Assert.Equal("02/15/2024 01:00:00", cut.Instance.Value.ToString("MM/dd/yyyy HH:mm:ss"));
     }
 
+    [Fact]
+    public void DisableDayPredicate_Ok()
+    {
+        var cut = Context.RenderComponent<DateTimePicker<DateTime?>>(pb =>
+        {
+            pb.Add(a => a.DisableDayPredicate, DisableToday);
+            pb.Add(a => a.Value, DateTime.Today);
+        });
+        Assert.Null(cut.Instance.Value);
+        Assert.DoesNotContain("btn picker-panel-link-btn is-now", cut.Markup);
+        Assert.Contains("today disabled", cut.Markup);
+
+        cut.SetParametersAndRender(pb =>
+        {
+            pb.Add(a => a.Value, DateTime.Today.AddDays(1));
+        });
+        Assert.Equal(DateTime.Today.AddDays(1), cut.Instance.Value);
+
+        cut.SetParametersAndRender(pb =>
+        {
+            pb.Add(a => a.DisableDayPredicate, DisableYesterday);
+            pb.Add(a => a.Value, DateTime.Today);
+        });
+        Assert.Equal(DateTime.Today, cut.Instance.Value);
+        Assert.Contains("btn picker-panel-link-btn is-now", cut.Markup);
+    }
+
+    private bool DisableToday(DateTime day)
+    {
+        return day.Date == DateTime.Today;
+    }
+
+    private bool DisableYesterday(DateTime day)
+    {
+        return day.Date == DateTime.Today.AddDays(-1);
+    }
+
     class MockDateTimePicker : DatePickerBody
     {
         public static bool GetSafeYearDateTime_Ok()