feat: 增加 FirstDayOfWeek 设置

Author: ArgoZhang

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

@@ -20,7 +20,7 @@ private DateTime StartDate
         get
         {
             var d = GetSafeDayDateTime(CurrentDate, 1 - CurrentDate.Day);
-            d = GetSafeDayDateTime(d, 0 - (int)d.DayOfWeek);
+            d = GetSafeDayDateTime(d, (int)FirstDayOfWeek - (int)d.DayOfWeek);
             return d;
         }
     }
@@ -388,6 +388,12 @@ public bool AllowNull
     [Parameter]
     public bool EnableDisabledDaysCache { get; set; } = true;
 
+    /// <summary>
+    /// 获得/设置 星期第一天 默认 <see cref="DayOfWeek.Sunday"/>
+    /// </summary>
+    [Parameter]
+    public DayOfWeek FirstDayOfWeek { get; set; } = DayOfWeek.Sunday;
+
     [Inject]
     [NotNull]
     private ICalendarFestivals? CalendarFestivals { get; set; }
@@ -494,7 +500,7 @@ protected override void OnParametersSet()
         YearPeriodText ??= Localizer[nameof(YearPeriodText)];
         MonthLists = [.. Localizer[nameof(MonthLists)].Value.Split(',')];
         Months = [.. Localizer[nameof(Months)].Value.Split(',')];
-        WeekLists = [.. Localizer[nameof(WeekLists)].Value.Split(',')];
+        WeekLists = GetWeekList();
 
         Today ??= Localizer[nameof(Today)];
         Yesterday ??= Localizer[nameof(Yesterday)];
@@ -513,7 +519,9 @@ protected override async Task OnParametersSetAsync()
     {
         await base.OnParametersSetAsync();
 
+        _render = false;
         await UpdateDisabledDaysCache(true);
+        _render = true;
     }
 
     private bool _render = true;
@@ -523,6 +531,15 @@ protected override async Task OnParametersSetAsync()
     /// </summary>
     protected override bool ShouldRender() => _render;
 
+    private List<string> GetWeekList()
+    {
+        var list = Localizer[nameof(WeekLists)].Value.Split(',', StringSplitOptions.RemoveEmptyEntries).ToList();
+
+        // 调整顺序
+        var firstDayIndex = (int)FirstDayOfWeek;
+        return list.Skip(firstDayIndex).Concat(list.Take(firstDayIndex)).ToList();
+    }
+
     private async Task UpdateDisabledDaysCache(bool force)
     {
         if (OnGetDisabledDaysCallback != null)

src/BootstrapBlazor/Components/DateTimePicker/DateTimePicker.razor

@@ -13,7 +13,7 @@
     {
         <i class="@DateTimePickerIconClassString"></i>
     }
-    <DatePickerBody @bind-Value="SelectedValue" @ref="_pickerBody"
+    <DatePickerBody @bind-Value="SelectedValue" @ref="_pickerBody" FirstDayOfWeek="FirstDayOfWeek"
                     ShowClearButton="AllowNull" ShowSidebar="ShowSidebar" SidebarTemplate="SidebarTemplate"
                     DateTimeFormat="@DateTimeFormat" DateFormat="@DateFormat" TimeFormat="@TimeFormat" ShowFooter="true"
                     ShowLunar="ShowLunar" ShowSolarTerm="ShowSolarTerm" ShowFestivals="ShowFestivals" ShowHolidays="ShowHolidays"

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

@@ -86,6 +86,12 @@ public string? Format
     [NotNull]
     public string? TimeFormat { get; set; }
 
+    /// <summary>
+    /// 获得/设置 星期第一天 默认 <see cref="DayOfWeek.Sunday"/>
+    /// </summary>
+    [Parameter]
+    public DayOfWeek FirstDayOfWeek { get; set; } = DayOfWeek.Sunday;
+
     /// <summary>
     /// 获得/设置 组件图标 默认 fa-regular fa-calendar-days
     /// </summary>