【PHP】Carbonインスタンスに指定した時間を足すことができるCarbon::addHoursメソッドを解説します

PHP

2026.01.06

こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在5社経験している、14年目エンジニアです。

この記事では、 PHPでCarbonインスタンスに指定した時間を足すことができるCarbon::addHoursメソッドについて

Carbon::addHoursメソッドとは
Carbon::addHoursメソッドを使ったサンプルプログラム

と、丁寧に解説していきます。

前提条件：実行環境について
Carbon::addHoursメソッドとは
Carbon::addHoursメソッドを解説するプログラムの概要
PHPサンプルプログラム
実行結果
まとめ：Carbon::addHoursメソッドを使ってみよう！

前提条件：実行環境について

実行環境は以下の通りです。

OS	Windows11
PHPのバージョン	8.2.4
XAMPPのバージョン	8.2.4
Carbonライブラリのバージョン	2.71.0

PHPを動かすためにXAMPPを使っています。
XAMPPのインストールは、下の記事をご参考ください。

【XAMPP】インストールするやり方を解説します（Windows11向け）

Carbon::addSecondsメソッドが属しているCarbonライブラリとは、年月日や時間を扱うライブラリです。
Carbonライブラリの基本的な使い方については、こちらの記事をご参考ください。

【PHP】Carbonライブラリの基本的な使い方を解説します

Carbon::addHoursメソッドとは

Carbon::addHoursメソッドとは、呼び出しているCarbonインスタンスに引数で指定されている時間を足すメソッドです。

使い方サンプルは以下になります。

$sample = new Carbon('2000-01-01 00:00:00');
$sample->addHours(10);

1 2	$sample = new Carbon('2000-01-01 00:00:00'); $sample->addHours(10);

実行後は変数sampleは

2000-01-01 10:00:00

1	2000-01-01 10:00:00

という値になっています。

Carbon::addHoursメソッドの引数は任意設定です。
設定しなかった場合、1時間追加されます。
ちなみに引数には負の整数も設定でき、その場合指定した数だけ時間が引かれます。

では、次の章で実際に使ってみます。

Carbon::addHoursメソッドを解説するプログラムの概要

Carbon::addHoursメソッドを解説するプログラムでは

引数指定なしの場合
正の整数で引数指定ありの場合
負の整数で引数指定ありの場合

の3パターンでCarbon::addHoursメソッドを実行し、結果を表示させます。

phpプログラムは

C:\xampp\htdocs

配下に、【sample.php】というファイル名で格納しています。
PHPのCarbon::addSecondsメソッドを解説

PHPサンプルプログラム

<?php
    require __DIR__ . "/../vendor/autoload.php";

    use Carbon\Carbon;

    print('■Carbon::addHoursメソッドサンプル<br >');

    print('・引数指定なしの場合<br >');
    $carbon1 = new Carbon('2026-02-01 00:00:00');
    print("実行前：" . $carbon1 . "<br >");
    $carbon1->addHours();
    print("実行後：" . $carbon1 . "<br >");

    print('・正の整数で引数指定ありの場合<br >');
    $carbon2 = new Carbon('2026-02-01 00:00:00');
    print("実行前：" . $carbon2 . "<br >");
    $carbon2->addHours(24);
    print("実行後：" . $carbon2 . "<br >");

    print('・負の整数で引数指定ありの場合<br >');
    $carbon3 = new Carbon('2026-02-01 00:00:00');
    print("実行前：" . $carbon3 . "<br >");
    $carbon3->addHours(-3);
    print("実行後：" . $carbon3 . "<br >");
?>

<?php

require __DIR__ . "/../vendor/autoload.php";

use Carbon\Carbon;

print('■Carbon::addHoursメソッドサンプル ');

print('・引数指定なしの場合 ');

$carbon1 = new Carbon('2026-02-01 00:00:00');

print("実行前：" . $carbon1 . " ");

$carbon1->addHours();

print("実行後：" . $carbon1 . " ");

print('・正の整数で引数指定ありの場合 ');

$carbon2 = new Carbon('2026-02-01 00:00:00');

print("実行前：" . $carbon2 . " ");

$carbon2->addHours(24);

print("実行後：" . $carbon2 . " ");

print('・負の整数で引数指定ありの場合 ');

$carbon3 = new Carbon('2026-02-01 00:00:00');

print("実行前：" . $carbon3 . " ");

$carbon3->addHours(-3);

print("実行後：" . $carbon3 . " ");

Carbonインスタンスをnewで生成するやり方は、こちらの記事をご参考ください。

【PHP】Carbonインスタンスをnewで生成するやり方について解説します

実行結果

XAMPPを起動して、【http://localhost/sample.php】のURLにアクセスします。

XAMPPでPHPの動かし方については、こちらの記事をご参考ください。

XAMPPでApacheの動かし方を解説します（Windows11向け）

PHPのCarbon::addHoursメソッドを解説

引数を指定なしの場合は1時間、引数を指定している場合は指定した秒数分足したり引いたりしていることが確認できました！

まとめ：Carbon::addHoursメソッドを使ってみよう！

以上がCarbon::addHoursメソッドについての解説でした！

あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ