Laravel模型中多日期属性的自定义日期格式实现方案

我有一个名为CostingSheetFabric的Laravel模型，在$dates属性中定义了customer_start_date、customer_cancel_date、earliest_start_date、earliest_cancel_date等多个日期字段，希望自定义这些属性从数据库取出时的日期格式。

我尝试在模型中使用如下asDateTime方法，但似乎不适用当前场景：

protected function asDateTime($value)
{
    return parent::asDateTime($value)->format('Y-m-d');
}

想请教：

1. 处理多日期属性时，使用asDateTime是否是推荐的自定义日期格式的方法？
2. 由于模型可能包含35个日期字段，逐个定义$dates或编写访问器的方式不可行，且尝试过的方法无效，该怎么处理？

附尝试过的无效代码：
定义$dates：

protected $dates = [
    'custom_date',
];

编写访问器：

public function getStartDateAttribute($value)
{
    return Carbon::parse($value)->format("Y-m-d");
}

关于asDateTime的适用性 #

asDateTime的核心作用是将数据库值转换为Carbon实例，而非直接返回格式化后的字符串。你之前的写法会把日期字段变成纯字符串，丢失Carbon自带的日期计算、比较等所有功能，违背Laravel的设计逻辑，因此不推荐这么用。

批量处理多日期字段的格式化 #

针对35个日期字段的批量需求，推荐以下两种实用方案：

方案1：利用serializeDate方法（优先推荐）

这个方法专门控制日期字段在**序列化（转数组、JSON输出）**时的格式，既保留Carbon实例的全部功能，又能在输出时得到指定格式：

use Illuminate\Database\Eloquent\Model;
use Carbon\CarbonInterface;

class CostingSheetFabric extends Model
{
    // Laravel 7及以下用$dates定义日期字段
    protected $dates = [
        'customer_start_date',
        'customer_cancel_date',
        'earliest_start_date',
        'earliest_cancel_date',
        // 其他31个日期字段...
    ];

    // Laravel 8+更推荐用$casts，写法更清晰
    // protected $casts = [
    //     'customer_start_date' => 'date',
    //     'customer_cancel_date' => 'date',
    //     // ...批量添加所有日期字段
    // ];

    protected function serializeDate(CarbonInterface $date)
    {
        return $date->format('Y-m-d');
    }
}

方案2：动态生成访问器（适合强制返回字符串的场景）

如果必须让字段取出时直接是格式化后的字符串（不建议，会丢失Carbon功能），可以通过动态属性获取逻辑批量处理：

use Carbon\Carbon;

class CostingSheetFabric extends Model
{
    protected $dates = [/* 所有日期字段 */];

    public function __get($key)
    {
        // 判断当前字段是否在日期列表中
        if (in_array($key, $this->dates)) {
            $value = parent::__get($key);
            return $value instanceof Carbon ? $value->format('Y-m-d') : $value;
        }

        return parent::__get($key);
    }
}

注意：该方法会覆盖默认属性获取逻辑，使用前需测试是否影响其他字段。

批量定义日期字段的小技巧 #

如果35个字段逐个编写太繁琐，可以先整理字段名到数组，再批量赋值：

class CostingSheetFabric extends Model
{
    private $dateFields = [
        'customer_start_date',
        'customer_cancel_date',
        'earliest_start_date',
        'earliest_cancel_date',
        // 其他日期字段...
    ];

    protected $dates = [];

    public function __construct(array $attributes = [])
    {
        parent::__construct($attributes);
        // 批量赋值到dates
        $this->dates = $this->dateFields;
        // 如果用casts的话：
        // $this->casts = array_fill_keys($this->dateFields, 'date');
    }
}

内容的提问来源于stack exchange，提问作者Colette Abbott