金曜の受付から土日と月曜の休業日を除き、火曜を期限にする営業日加算のアイキャッチ

実装・エラー解決

Javaで営業日を加算する|LocalDateで土日・休業日を除く

金曜に受け付けた社内申請へ、1営業日以内に回答します。月曜は社内の休業日なので、担当者が作業できる最初の日は火曜です。ところが receivedOn.plusDays(1) で期限を計算すると、回答できない土曜が画面に表示されます。

営業日を加算するには、日付を1日ずつ進めながら、土日でも指定の休業日でもない日にだけ残り日数を減らします。受付日を数えるか、0営業日をどの日にするかは、先に仕様として決めます。

この記事でわかること

  • 金曜受付で月曜が休業のとき、火曜を回答期限にする数え方
  • LocalDate と休業日の集合を使い、営業日だけを加算するJavaコード
  • 受付日・0営業日・年またぎ・上限をJUnitで確かめる方法

記事と同じコードを実行する

JDK 17とMaven 3.9系で mvn test を実行できます。ZIPには営業日加算のJava本体、JUnitテスト、pom.xml、READMEを収録しています。修正版で10件を確認し、本文に沿って暦日加算のずれも再現できます。

サンプルZIPをダウンロード GitHubでコード全文と実行手順を見る

金曜からplusDays(1)すると、休業日に関係なく土曜になる

受付日は2026年11月13日(金)、回答まで1営業日、翌月曜の16日は社内休業日です。LocalDate.plusDays は暦上の日数を加えた日付を返します。戻り値を受け取っても、土日や会社のカレンダーを参照する処理はないため、11月14日(土)になります。Java 17のLocalDate.plusDaysの仕様で、メソッドが加える日数と返す値を確認できます。

再現用の抜粋(営業日判定を暦日加算に置き換える)

return receivedOn.plusDays(businessDays);

手元で再現するなら、ZIPを別の場所に展開し、BusinessDays.java の LocalDate date = receivedOn; から最後の return date; までを、上の return 1行に置き換えます。その状態で mvn test を実行します。金曜から1営業日後のテストは、期待値が11月17日、実際の値が11月14日で失敗します。配布ZIPの元のコードには、この置き換えを入れていません。

結果が土曜になる場合は、日付を進める処理は動いています。呼び出しても元の受付日から動かない場合は、plusDays が返した新しい日付を受け取っているかを先に確認します。

関連記事LocalDate.plusDaysで日付が変わらない理由|戻り値を代入する必要がある 日付自体が進まないときに、LocalDateが返した値をどこで受け取るか確認できます。 記事を読む

受付日の翌日から数え、0営業日なら受付日を返す

「1営業日後」と言われたら、金曜受付を当日1日目と数える部署も、次の営業日を1日目とする部署もあり得ます。この申請システムでは、すでに確定した受付日を起点とし、1以上なら翌日から数えます。休日に届いた依頼の受付日をいつにするかは、受付処理側で決めてこのメソッドへ渡します。

入力・条件回答期限の扱い
1〜60営業日受付日の翌日から、土日と指定休業日を飛ばして数える
0営業日受付日を返す。起点が休業日でも繰り延べない
負数または61以上IllegalArgumentException で拒否する
日付の表現範囲を超えるDateTimeException で失敗する

0は「翌営業日に繰り延べる」の意味にせず、日数を足さずに起点を返すと決めています。上限の60は社内申請の入力条件を例として置いた値です。マイナスを認めないため、過去の営業日を逆にたどる動きは持たせていません。受付日・休業日の集合・集合の要素は必須で、休業日を指定しないときは Set.of() を渡します。

日付は毎回進め、土日・休業日では残り日数を減らさない

金曜を date、残りを1とします。ループの最初に date を1日進めます。土曜、日曜、月曜は日付だけが進み、残りは1のままです。火曜に着いて初めて残りを0にします。そこでループが終わるので、現在の date が期限です。

11月13日受付の1営業日後を、残り日数で追う
  1. 受付日残り1日
  2. 週末で除外残り1日
  3. 週末で除外残り1日
  4. 社内休業で除外残り1日
  5. 営業日なので期限残り0日

2営業日なら、同じ火曜に着いたとき残りは1です。次の水曜が営業日なので、そこで0になります。休日を飛ばすたびに「期限へさらに1日足す」という見方をすると、土曜を休業日一覧にも入れた場合に同じ日を二重に補正しかねません。このループは、日付ごとに「数える・数えない」を一度だけ決めます。

LocalDateと休業日のSetで、営業日にだけremainingを減らす

BusinessDays.java(全文)

package info.syachiku.calendar;

import java.time.DayOfWeek;
import java.time.LocalDate;
import java.util.Objects;
import java.util.Set;

public final class BusinessDays {
    private static final int MAX_BUSINESS_DAYS = 60;

    private BusinessDays() {
    }

    public static LocalDate add(LocalDate receivedOn, int businessDays, Set<LocalDate> closedDates) {
        Objects.requireNonNull(receivedOn, "receivedOn");
        if (businessDays < 0 || businessDays > MAX_BUSINESS_DAYS) {
            throw new IllegalArgumentException("営業日数は0〜60で指定してください");
        }
        Set<LocalDate> closures = Set.copyOf(closedDates);

        LocalDate date = receivedOn;
        int remaining = businessDays;
        while (remaining > 0) {
            date = date.plusDays(1);
            DayOfWeek dayOfWeek = date.getDayOfWeek();
            if (dayOfWeek != DayOfWeek.SATURDAY
                    && dayOfWeek != DayOfWeek.SUNDAY
                    && !closures.contains(date)) {
                remaining--;
            }
        }
        return date;
    }
}

date = date.plusDays(1) を曜日の判定より先に書くため、受付日を数えません。getDayOfWeek() が返す DayOfWeek を土曜・日曜と比較します。平日でも closures.contains(date) が真なら、remaining-- へ進みません。Java 17のDayOfWeekの仕様に曜日を表す列挙値があります。

Set.copyOf(closedDates) で渡された日付の集合をコピーし、ループはその内容を参照します。曜日判定と同じ日付で集合を引くため、休業日が土日にも登録されていても、カウンターの結果は変わりません。月末と年末の次の日は LocalDate が計算します。翌年の1月1日を営業日から外す判断は、翌年の日付も含む集合に任せます。

JUnitで1営業日と2営業日を比べ、0・年またぎ・上限も確かめる

ZIPを展開したら pom.xml のあるフォルダで mvn test を実行します。JDK 17、Maven 3.9系、JUnit Jupiter 5.12.2、Surefire 3.5.3で確認しています。LocalDate.now() を使わず、受付日と休業日を各ケースで固定しているため、いつ実行しても同じ条件で比べられます。

主なケース入力期待する結果
週末と社内休業日11/13(金)に受付、11/16(月)が休業、1営業日後11/17(火)
同じ受付日で2営業日休業日は同じまま、日数を2にする11/18(水)
0営業日受付日として渡した11/16が休業、日数は011/16のまま
年またぎ2026/12/31に受付、翌年1/1と1/4が休業、1営業日後2027/01/05
入力値と日付の上限60、61、負数、または LocalDate.MAX に1を加算60は有効、61と負数は入力エラー、日付範囲超過は日付エラー

通常の平日で翌日から数えるケースと、土曜も休業日に登録したケースを合わせて10件です。受け付けた木曜を誤って1日目にすると、金曜を期待する startsWithTheFollowingDay が失敗します。0のテストは休業日を起点にし、0を「次に開く日」へ変える変更を検出します。年またぎでは、元日のほか月曜の1月4日も集合に入れているため、土日を飛ばすだけでは通りません。

BusinessDaysTest.java(全文)
package info.syachiku.calendar;

import java.time.DateTimeException;
import java.time.LocalDate;
import java.util.Set;

import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

class BusinessDaysTest {
    private static final LocalDate FRIDAY = LocalDate.of(2026, 11, 13);
    private static final LocalDate MONDAY_CLOSURE = LocalDate.of(2026, 11, 16);

    @Test
    void skipsWeekendAndCompanyClosure() {
        assertEquals(LocalDate.of(2026, 11, 17),
                BusinessDays.add(FRIDAY, 1, Set.of(MONDAY_CLOSURE)));
    }

    @Test
    void countsTwoOpenDays() {
        assertEquals(LocalDate.of(2026, 11, 18),
                BusinessDays.add(FRIDAY, 2, Set.of(MONDAY_CLOSURE)));
    }

    @Test
    void startsWithTheFollowingDay() {
        assertEquals(FRIDAY,
                BusinessDays.add(LocalDate.of(2026, 11, 12), 1, Set.of()));
    }

    @Test
    void leavesClosedStartForZero() {
        assertEquals(MONDAY_CLOSURE,
                BusinessDays.add(MONDAY_CLOSURE, 0, Set.of(MONDAY_CLOSURE)));
    }

    @Test
    void crossesYearWithProvidedClosures() {
        var closures = Set.of(LocalDate.of(2027, 1, 1), LocalDate.of(2027, 1, 4));
        assertEquals(LocalDate.of(2027, 1, 5),
                BusinessDays.add(LocalDate.of(2026, 12, 31), 1, closures));
    }

    @Test
    void doesNotShiftForAnExtraClosedWeekendDate() {
        var closures = Set.of(LocalDate.of(2026, 11, 14), MONDAY_CLOSURE);
        assertEquals(LocalDate.of(2026, 11, 17),
                BusinessDays.add(FRIDAY, 1, closures));
    }

    @Test
    void allowsSixtyBusinessDays() {
        assertEquals(LocalDate.of(2027, 2, 8),
                BusinessDays.add(LocalDate.of(2026, 11, 16), 60, Set.of()));
    }

    @Test
    void rejectsNegativeDays() {
        assertThrows(IllegalArgumentException.class,
                () -> BusinessDays.add(FRIDAY, -1, Set.of()));
    }

    @Test
    void rejectsMoreThanSixty() {
        assertThrows(IllegalArgumentException.class,
                () -> BusinessDays.add(FRIDAY, 61, Set.of()));
    }

    @Test
    void failsWhenResultExceedsLocalDateMax() {
        assertThrows(DateTimeException.class,
                () -> BusinessDays.add(LocalDate.MAX, 1, Set.of()));
    }
}
pom.xml(全文)
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>info.syachiku</groupId>
  <artifactId>localdate-business-days-sample</artifactId>
  <version>1.0.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
      <version>5.12.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.3.1</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.14.1</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>3.5.3</version>
      </plugin>
    </plugins>
  </build>
</project>

修正版は10件成功します。冒頭の暦日加算に置き換えると、週末と休業日をまたぐ日付や、60営業日を数える結果が変わり、10件中5件が失敗します。ログの expected と but was の差から、入力エラーの扱いを変える前に、数える日の判定を確認できます。

修正版と暦日加算に置き換えた再現版のログ抜粋

修正版の mvn test
[INFO] Tests run: 10, Failures: 0, Errors: 0, Skipped: 0

暦日加算に置き換えた再現版の mvn test
[ERROR]   BusinessDaysTest.skipsWeekendAndCompanyClosure:18 expected: <2026-11-17> but was: <2026-11-14>
[ERROR]   BusinessDaysTest.crossesYearWithProvidedClosures:43 expected: <2027-01-05> but was: <2027-01-01>
[ERROR] Tests run: 10, Failures: 5, Errors: 0, Skipped: 0

実運用では、誰の休業日をどこまで用意するかを確認する

レビューコメント例「月曜休業なら火曜になることは確認できました。12月末の受付で翌年へ進むときも、翌年の休業日一覧を渡せますか。年をまたぐテストの1月4日が渡らない場合、月曜を営業日として数えます。」

祝日、年末年始、臨時休業のうち、どの日を除くかは窓口や拠点の運用次第です。たとえば翌年の休業日が未登録のとき、空の集合で計算を続けると、システムは「指定休業日なし」と扱います。入力元で対象拠点と休業日データの対象期間を確認し、必要な日付が用意できないときの扱いを先に決めます。加算日数が60以内でも、60暦日分のカレンダーでは土日や休業日の先まで足りません。

「金曜17時以降に届いたら翌営業日受付」という条件があるなら、先に受信時刻を対象拠点の時間帯で評価して受付日を決めます。今回のメソッドが受け取るのはその確定済みの日付です。日付に時刻を混ぜず、受付の締め時刻と回答期限の営業日計算を別々にテストできます。

提出前に、休業日をまたぐ入力と0営業日を確かめる

  • 受付日を数え始める日と、0営業日の扱いを仕様で確認した。
  • 土日と除外する日付を別に確認し、同じ休業日を二重に補正しない。
  • 金曜受付で翌月曜が休業のケースを作り、火曜を期待値にした。
  • 年またぎでは、次の年の休業日が計算へ渡ることを確認した。
  • 入力値の上限とLocalDateの表現範囲を分け、どちらも実行した。

LocalDate と while を一緒に読むところで手が止まったら、『スッキリわかるJava入門 第5版』の条件分岐・繰り返しと、日付の扱いを扱う章を参照できます。日付を1日動かす行と、営業日だけカウンターを減らす条件を切り分けて読むための土台になります。

書籍「スッキリわかるJava入門 第5版」の表紙
商品画像:Amazon.co.jp
PR Java初学者向け

スッキリわかるJava入門 第5版

中山 清喬 (著), 国本 大悟 (著), 株式会社フレアリンク (監修)

変数・条件分岐から、クラスの基本まで学ぶ一冊。

豊富な図とサンプルで、変数、条件分岐、クラス、例外処理まで順番に学べます。Javaの最初の教科書を探している人向けです。

  • Javaを基礎から体系的に学びたい
  • Java 25 LTS対応の入門書を選びたい

当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。

関連記事Javaの現在日時をテストで固定する方法|Clock.fixedで期限判定を確認する 受付日を決める側で現在時刻を参照するなら、Clock.fixedで締切前後の時刻を固定して試せます。 記事を読む 関連記事テストケースの作り方|仕様・境界値・期待結果をJUnitと対応させる実例 0営業日や上限の前後のように、仕様を入力と期待値へ落とす手順を学べます。 記事を読む

まとめ

営業日を加算するときは、受付日と0営業日の扱いを決め、日付を1日ずつ進めながら営業日だけを数えます。金曜から火曜になるケースと年をまたぐケースをテストに残し、計算に使った休業日と期待する期限を説明できるようにします。

-実装・エラー解決
-, ,