Bootstrap Datepicker仅选年份无法绑定MVC模型Nullable DateTime属性

你遇到的问题本质是：MVC的模型绑定器无法把纯年份字符串（比如2024）转换成Nullable<DateTime>类型。因为DateTime必须包含年、月、日三个部分，而只选年份的输入没有提供月和日，绑定器不知道该怎么解析，所以直接把ReplacementDate设为null了。

反观你的年月选择器，提交的是mm/yyyy格式（比如05/2024），绑定器会自动默认补全当月的第一天（比如2024-05-01），所以能正常完成绑定。

我给你整理了三个靠谱的解决思路，你可以根据业务需求选择：

方案1：前端补全完整日期（最推荐） #

修改年份选择器的配置，在用户选中年份后，自动把日期补全为当年的1月1日，这样提交的就是完整的日期字符串，绑定器就能正常识别了：

$('.input-group.decade').datepicker({
    format: "yyyy",
    viewMode: "years",
    minViewMode: "years",
    keyboardNavigation: false,
    forceParse: false,
    autoclose: true,
    showOnFocus: false,
    // 新增选择回调，补全月日为1月1日
    onSelect: function(dateText) {
        const fullDate = new Date(dateText, 0, 1); // 月份是0基，0代表1月
        $(this).datepicker('setDate', fullDate);
    }
});

用户操作时看到的还是年份选择器，但实际提交给后端的是2024-01-01这类完整日期，完美适配Nullable<DateTime>属性。

方案2：自定义模型绑定器（后端适配） #

如果不想改动前端逻辑，可以给ReplacementDate写个专属的模型绑定器，让它能把纯年份字符串转换成DateTime：

public class YearToDateTimeBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var yearValue = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (yearValue == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, yearValue);
        if (int.TryParse(yearValue.FirstValue, out int year))
        {
            // 把年份转成当年1月1日的DateTime
            bindingContext.Result = ModelBindingResult.Success(new DateTime(year, 1, 1));
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "请输入有效的年份");
        }

        return Task.CompletedTask;
    }
}

然后在模型属性上标记这个绑定器：

[ModelBinder(typeof(YearToDateTimeBinder))]
public DateTime? ReplacementDate { get; set; }

这样后端就能自动把纯年份字符串转换成DateTime值了。

方案3：改成Nullable类型（业务允许的话最简洁） #

如果你的业务逻辑只需要存储年份，完全不需要完整日期，那直接把属性改成int?是最简单的办法：

public int? ReplacementDate { get; set; }

前端提交的纯年份数字可以直接绑定，不需要任何额外处理。

如果以后可能需要用到完整日期，优先选方案1；如果业务只需要年份，方案3最省心；没法改前端的话就用方案2。

内容的提问来源于stack exchange，提问作者Bad Dub