【Laravel】Carbonで日時操作する時に気を付けること

• Carbon/Carbon

通常のCarbonはmutable(変更可能)なので作成したインスタンスが書き換えられてしまう。

<?php
use Carbon/Carbon;

$now = Carbon::now();
$tomorrow = $now->addDay();

echo $now->format('Y/m/d H:i:s') // "2023/02/22 12:14:00"
echo $tomorrow->format('Y/m/d H:i:s') // "2023/02/22 12:14:00"

• Carbon\CarbonImmutable

CarbonImmutableは(変更不可能)なので作成したインスタンスは値が保持される。

<?php
use Carbon/CarbonImmutable;

$now = CarbonImmutable::now();
$tomorrow = $now->addDay();

echo $now->format('Y/m/d H:i:s') // "2023/02/21 12:14:00"
echo $tomorrow->format('Y/m/d H:i:s') // "2023/02/22 12:14:00"

Carbonクラスでもcopy()で最初に作成したインスタンスをコピーできる。
※書き忘れなどが生じるためCarbonImmutable推奨

<?php
use Carbon/Carbon;

$now = Carbon::now();
$tomorrow = $now->copy()->addDay();

echo $now->format('Y/m/d H:i:s') // "2023/02/21 12:14:00"
echo $tomorrow->format('Y/m/d H:i:s') // "2023/02/22 12:14:00"

結論

CarbonImmutableを使用した方が、思わぬエラーを回避できる