HandsOnChain

締め切りと営業日で約定日を決める

作るもの

このレッスンを終えると、注文した時刻から約定日が決まります。
営業日の15時ちょうどまでの注文はその日の約定日に入り、15時を過ぎた注文は次の営業日の約定日に入ります。
土曜と日曜の注文も、次の営業日の月曜の約定日に入ります。

2026-03-05(木)の15:00:00の注文は約定日20517に入り、1秒後の15:00:01の注文は金曜の20518に入ります。
運用会社が土日の約定日に純資産を入れようとすると、NotBusinessDayのエラーで拒みます。

背景

投資信託の申込と解約には、ファンドごとに1日の締め切りの時刻があります。
この時刻を申込締切時間と呼び、ファンドの交付目論見書に書かれています。
販売会社が、それより早い受付の時刻を決めることもあります。
締め切りまでに受けた注文はその日の注文になり、締め切りを過ぎた注文は次の営業日に受けた注文として扱います。

営業日は、販売会社が注文を受けて手続きを進める日です。
土日と祝日と年末年始は営業日に当たらず、その日の注文は次の営業日の注文になります。
海外の資産に投資するファンドには、海外の取引所や銀行の休みに合わせて注文を受けない申込不可日もあります。
このコースでは土曜と日曜だけを休みにし、祝日と年末年始と申込不可日は扱いません。

締め切りを置くのは、ブラインド方式を守るためです。
その日の基準価額は、その日の市場の値段で組み入れた資産を評価して、締め切りの後に出ます。
締め切りの後でもその日の注文を受けると、値動きを知ってから注文した人が得をし、持ち続ける人が損をします。
締め切りで注文を区切るので、同じ約定日の注文は全員が値段を知らないまま、同じ基準価額で約定します。

このコースでは、毎営業日の日本時間の15時を締め切りにします。
15時ちょうどの注文はその日に入れ、15時を1秒でも過ぎた注文は次の営業日に入れます。

注文した時刻で入る約定日が変わる
5日5日木曜の約定日20517に入る5〜6日5〜6日金曜の約定日20518に入る6〜9日6〜9日月曜の約定日20521に入る5日6日7日8日9日営業日に数えない木曜15時金曜15時月曜15時112233
注文した時刻 (日本時間) 日付の番号 入る約定日
3月5日(木)15:00:00 20517 20517 (木)
3月5日(木)15:00:01 20517 20518 (金)
3月6日(金)16:00 20518 20521 (月)
3月7日(土)10:00 20519 20521 (月)
3月8日(日)23:59 20520 20521 (月)

チェーンの上では、注文の時刻はブロックの時刻のblock.timestampで決まります。
ブロックの時刻は協定世界時の秒なので、9時間を足して日本時間の日付と時刻にします。
締め切りに使うのは取引を送った時刻ではなく、取引が入ったブロックの時刻です。
15時の直前に送った注文でも、15時を過ぎたブロックに入れば次の営業日の注文になります。

約定日を決める決まりはコントラクトのコードに書かれ、誰の注文にも同じ決まりが当たります。
注文の時刻と入った約定日は列に残るので、締め切りに間に合ったかを投資家も運用会社も後から確かめられます。

実装

starter/contracts/contracts/TokenizedFund.solを開き、YENの下に締め切りの時刻を足します。

    /// @notice 円トークンの1円 (18桁)
    uint256 public constant YEN = 1e18;
    /// @notice 申込と解約の締め切り (日本時間の15時)
    uint256 public constant CUTOFF = 15 hours;

CUTOFFは、日本時間の0時から15時までの54,000秒です。

エラーの末尾に、営業日でない約定日を拒むエラーを足します。

    error ZeroAmount();
    error NotBusinessDay(uint256 day);

setNavに、営業日かを確かめる行を足します。

    function setNav(uint256 day, uint256 netAssets) external onlyRole(MANAGER_ROLE) {
        if (day <= lastNavDay) revert NavOutOfOrder(day, lastNavDay);
        if (!isBusinessDay(day)) revert NotBusinessDay(day);
        uint256 nav = navFor(netAssets);

土日の約定日には注文が入らないので、運用会社が土日の基準価額を入れることもありません。
入れ間違えた時は、NotBusinessDayとその日の番号で拒みます。

setNavの後に、営業日と約定日を決める4つの関数を足します。

    /// @notice 土日を休みにし、月曜から金曜を営業日とする。祝日は数えない
    function isBusinessDay(uint256 day) public pure returns (bool) {
        // 1970-01-01は木曜なので、4を足して7で割った余りが0なら日曜、6なら土曜
        uint256 weekday = (day + 4) % 7;
        return weekday != 0 && weekday != 6;
    }

    /// @notice dayの次の営業日を返す
    function nextBusinessDay(uint256 day) public pure returns (uint256) {
        do {
            day += 1;
        } while (!isBusinessDay(day));
        return day;
    }

    /// @notice 注文した時刻から約定日を決める。営業日の15時ちょうどまではその日、15時を過ぎた注文と土日の注文は次の営業日
    function tradeDayOf(uint256 timestamp) public pure returns (uint256) {
        uint256 day = dayOf(timestamp);
        if (isBusinessDay(day) && (timestamp + JST) % 1 days <= CUTOFF) return day;
        return nextBusinessDay(day);
    }

    /// @notice 約定日の締め切りの時刻 (日本時間の15時)
    function cutoffAt(uint256 day) public pure returns (uint256) {
        return day * 1 days + CUTOFF - JST;
    }
行 意味
(day + 4) % 7 日の番号から曜日を出す。
0が日曜で、1から5が月曜から金曜、6が土曜
weekday != 0 && weekday != 6 日曜と土曜でなければ営業日。
祝日は数えない
do { day += 1; } while 少なくとも1日は進め、営業日に着くまで1日ずつ進める。
金曜から始めると、3回目で月曜に止まる
(timestamp + JST) % 1 days 日本時間の0時からの秒数。
15時ちょうどは54,000秒
<= CUTOFF 15時ちょうどまでをその日に入れる。
<=なので15:00:00はその日に入る
nextBusinessDay(day) 15時を過ぎた注文と土日の注文を、次の営業日に入れる
day * 1 days + CUTOFF - JST 約定日の日本時間の15時を、ブロックの時刻と同じ協定世界時の秒で返す

日の番号は、前の節のdayOfが返す1970-01-01からの通し番号です。
1970-01-01の番号0は木曜で、日曜を0、月曜を1と数えると木曜は4に当たります。
そのため番号に4を足して7で割ると、日曜を0とした曜日の番号になります。
2026-03-05の20517は7でちょうど割り切れるので、(20517 + 4) % 7は4で木曜です。

cutoffAtは、次のレッスンの取り消しの期限と、次の節で純資産を入れてよい時刻に使います。
約定日20517の締め切りは1772690400で、協定世界時の2026-03-05の6時、日本時間の15時に当たります。

tradeDayOfの分かれ方を図にすると、次の形になります。

注文した時刻から約定日を決める
土日15時まで始まり終わり終わりtradeDayOfを呼ぶその日は営業日?15時ちょうどまで?次の営業日を約定日にするその日を約定日にする11223344営業日営業日営業日15時を過ぎた

最後に、注文を列に足す_placeOrderの1行目を、dayOfからtradeDayOfに書き換えます。

    function _placeOrder(Kind kind, uint256 amount) private returns (uint256 day, uint256 index) {
        day = tradeDayOf(block.timestamp);
        Order[] storage orders = _orders[day];

申込も解約も_placeOrderを通るので、どちらの注文にも同じ締め切りと営業日が当たります。

starter/contracts/test/TokenizedFund.t.solのTokenizedFundTestの末尾に、締め切りと週末のテストを2つ足します。

    function test_OrderAfterCutoffGoesToNextBusinessDay() public {
        // 15時ちょうどの注文はその日の約定日に入る
        vm.warp(_at(0, 15, 0));
        vm.prank(alice);
        (uint256 day,) = fund.subscribe(100_000);
        assertEq(day, THU);
        // 15時を1秒過ぎた注文は、次の営業日の金曜に入る
        vm.warp(_at(0, 15, 0) + 1);
        vm.prank(alice);
        (day,) = fund.subscribe(100_000);
        assertEq(day, THU + 1);
        assertEq(fund.ordersOf(THU).length, 1);
        assertEq(fund.ordersOf(THU + 1).length, 1);
    }

    function test_WeekendOrderGoesToMonday() public {
        // 金曜の15時の後と土曜と日曜の注文は、どれも月曜の約定日に入る
        uint256[3] memory times = [_at(1, 16, 0), _at(2, 10, 0), _at(3, 23, 59)];
        for (uint256 i = 0; i < times.length; i++) {
            vm.warp(times[i]);
            vm.prank(alice);
            (uint256 day,) = fund.subscribe(100_000);
            assertEq(day, THU + 4);
        }
        assertEq(fund.ordersOf(THU + 4).length, 3);
        assertFalse(fund.isBusinessDay(THU + 2));
        assertFalse(fund.isBusinessDay(THU + 3));
    }
テスト 確かめること
test_OrderAfterCutoffGoesToNextBusinessDay 木曜の15:00:00の申込は木曜の20517に入り、1秒後の15:00:01の申込は金曜の20518に入る。
2つの約定日の列に1件ずつ溜まる
test_WeekendOrderGoesToMonday 金曜の16時と土曜の10時と日曜の23時59分の申込が、どれも月曜の20521に入る。
土曜の20519と日曜の20520は営業日でない

_at(days_, hour, minute)は、木曜の日本時間の0時からdays_日後のhour時minute分の時刻を返すテストの関数です。
_at(0, 15, 0)は木曜の15時ちょうどで、THU + 1は金曜の20518、THU + 4は月曜の20521です。
日曜の23時59分は、月曜の0時の1分前です。
月曜の直前でも日付は日曜なので、次の営業日の月曜に入ります。

前のレッスンのテストは、木曜の10時に注文するので約定日はTHUのまま変わりません。
基準価額のテストも営業日のTHUに入れるので、NotBusinessDayでは拒まれません。

確かめる

starter/contractsのディレクトリで、Foundryのテストを実行します。

forge test

次の行が出れば、締め切りと営業日で約定日が決まっています。

[PASS] test_OrderAfterCutoffGoesToNextBusinessDay()
[PASS] test_WeekendOrderGoesToMonday()
Suite result: ok. 10 passed; 0 failed; 0 skipped

15時ちょうどをその日に入れる<=が効いていることも確かめます。
tradeDayOfの<= CUTOFFを< CUTOFFに書き換えて実行します。

        if (isBusinessDay(day) && (timestamp + JST) % 1 days < CUTOFF) return day;

15時ちょうどの注文まで金曜の20518に入るので、test_OrderAfterCutoffGoesToNextBusinessDayが失敗します。

[FAIL: assertion failed: 20518 != 20517] test_OrderAfterCutoffGoesToNextBusinessDay()

確かめたら、元の<=に戻しておきます。

曜日の計算で足す数を1つずらすと、どうなるかも試しておきます。
isBusinessDayの(day + 4) % 7を(day + 3) % 7に書き換えて実行します。

[FAIL: assertion failed: 20519 != 20521] test_WeekendOrderGoesToMonday()

曜日が1日ずれて土曜が営業日になり、金曜の16時の注文が土曜の20519に入ってしまいます。
木曜と金曜はずれても営業日のままなので、test_OrderAfterCutoffGoesToNextBusinessDayは通ったままです。
確かめたら、元の(day + 4) % 7に戻しておきます。
次のレッスンで、締め切りの前なら投資家が自分の注文を取り消せるようにします。