LoginSignup
19
13

More than 1 year has passed since last update.

LaravelでCarbon\CarbonとIlluminate\Support\CarbonとCarbon\CarbonImmutableで迷ったらCarbonImmutable

Last updated at Posted at 2021-12-21

Laravelの日時ライブラリ

Laravelを使い始めて日時ライブラリがたくさんあり、迷ったので備忘録として。

注意

Laravel8系での話になります。Laravel5系とかだとIlluminate\Support\Carbonはまたちょっと違うので参考程度にしてください。

Carbon\Carbon

おなじみの日時ライブラリ。組み込みのDateTimeクラスを継承している。
mutableなので、インスタンスを直接変更するため注意が必要。

$time = Carbon::create(2021, 12, 25); // 2021-12-25 00:00:00
$time->addDay(); // 2021-12-26 00:00:00
$time->addDay(); // 2021-12-27 00:00:00 (直感的には2021-12-26であってほしい)

Carbon::now()->copy()->addDay()のようにインスタンスをコピーしてから使わないとコードのあちこちで変更があった時に追うのが辛くなる。

テストで時間を固定させたい時は Carbon::setTestNow()

PHPに触り始めた人だとサラッと流しがちなのでバグの温床になりやすい。(1時間ハマった)

Illuminate\Support\Carbon

Carbon\CarbonCarbon\CarbonImmutableを拡張した日時ライブラリ。実装を見ると分かる通り、Laravel8だともうsetTestNow() しか実装がない。 (テストで日時を固定できるメソッド)

Carbon\CarbonImmutable

Carbonの immutable版。組み込みのDateTimeImmutableクラスを継承している。
こちらは新しいインスタンスが返されるため、copy()する必要がない。
インスタンスが作られた一番最初の状態を持つので、コードを順に追う必要がなくなる。

$time = CarbonImmutable::create(2021, 12, 25); // 2021-12-25 00:00:00
$time->addDay(); // 2021-12-26 00:00:00
$time->addDay(); // 2021-12-26 00:00:00 (宣言時のものを基準にする)

テストで時間を固定したい時は CarbonImmutable::setTestNow()

注意

CarbonImmutable::setTestNow()だと上手く時間が設定出来ない可能性があるので、テスト時のみCarbon::setTestNow()推奨

  • CarbonImmutable::setTestNow()だとCarbonImmutable::now()などの時間固定ができる。
  • Carbon::setTestNow()だとCarbon::now()などの時間固定が出来る。

DateTime

Carbonの元になっているPHP組み込みの日時ライブラリ。
何か特別な理由がない限りはLaravelではCarbonを使った方が楽に感じる。

DateTimeImmutable

CarbonImmutableの元になっているPHP組み込みの日時ライブラリ。
何か特別な理由がない限りはLaravelではCarbonImmutableを使った方が楽に感じる。

まとめ(CarbonImmutableを使おう)

出来ることならばCarbonImmutableを採用したい。(プロジェクトで統一することが一番大切)
また、DateTimeを使うことで柔軟なインターフェース設計にできることを@mpywさんに教えていただきました。
ありがとうございます:bow:

その他追記があれば随時更新していきます。

19
13
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
19
13