予約の空き枠と締め切りを、日本時間で正しく扱う実装。DBはUTCで保存し、判定と表示はAsia/Tokyoで行う。UTC 15時の日付の境界、「前日18時締め切り」の計算、Temporal・Intl・date-fns系の選び方、境界を固定するテスト

2026-10-08T14:59:59Z → 日本時間 2026-10-08 23:59:59
2026-10-08T15:00:00Z → 日本時間 2026-10-09 00:00:00

// naive.mjs — よく見かける書き方。サーバーのタイムゾーン（TZ）に結果が左右される
export function dateKey(instant) {
  return instant.toISOString().slice(0, 10); // UTC の日付になる
}
export function deadlineOf(slotStartsAt) {
  const d = new Date(slotStartsAt);
  d.setDate(d.getDate() - 1); // 「前日」…サーバーのタイムゾーンでの前日
  d.setHours(18, 0, 0, 0);     // 「18時」…サーバーのタイムゾーンでの18時
  return d;
}
export function isBookable(slotStartsAt, now) {
  return now < deadlineOf(slotStartsAt);
}
export function dayRange(dateStr) {
  const start = new Date(`${dateStr}T00:00:00`); // オフセットなし＝サーバーのタイムゾーンで解釈
  const end = new Date(start);
  end.setDate(end.getDate() + 1);
  return { start, end };
}

$ IMPL=naive TZ=Asia/Tokyo node --test booking-time.test.mjs
✖ UTC 14:59:59 は日本時間の同じ日、15:00 からは翌日
✔ 前日18時の締め切り：17:59:59 は受け付け、18:00:00 からは締め切り
✔ 朝9時より前の枠（UTC では前の日）でも、前日は日本時間で数える
✔ 月末をまたぐ：11月1日の枠の締め切りは10月31日18時
✔ 年をまたぐ：1月1日の枠の締め切りは12月31日18時
✔ うるう年：2028年3月1日の前日は2月29日、2027年は2月28日
✔ 日本時間の「10月9日の枠」を取る範囲は UTC 10/8 15:00 〜 10/9 15:00
ℹ pass 6
ℹ fail 1

$ IMPL=naive TZ=UTC node --test booking-time.test.mjs
✖ UTC 14:59:59 は日本時間の同じ日、15:00 からは翌日
✖ 前日18時の締め切り：17:59:59 は受け付け、18:00:00 からは締め切り
✖ 朝9時より前の枠（UTC では前の日）でも、前日は日本時間で数える
✖ 月末をまたぐ：11月1日の枠の締め切りは10月31日18時
✖ 年をまたぐ：1月1日の枠の締め切りは12月31日18時
✖ うるう年：2028年3月1日の前日は2月29日、2027年は2月28日
✖ 日本時間の「10月9日の枠」を取る範囲は UTC 10/8 15:00 〜 10/9 15:00
ℹ pass 0
ℹ fail 7

// jst.mjs — DB には UTC の時刻（timestamptz）を置き、日付の判定と表示だけを日本時間で行う
// サーバーの TZ に左右されないよう、Date のローカル時刻のメソッド（getDate・setHours など）は使わない
const TZ = 'Asia/Tokyo';
const JST_OFFSET = '+09:00'; // 日本は現在、夏時間がなく通年 UTC+9

const partsFmt = new Intl.DateTimeFormat('en-US', {
  timeZone: TZ, hourCycle: 'h23',
  year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit',
});

/** UTC の時刻 → 日本時間の年月日・時分 */
export function jstParts(instant) {
  const p = Object.fromEntries(partsFmt.formatToParts(instant).map(({ type, value }) => [type, value]));
  return { y: +p.year, m: +p.month, d: +p.day, hh: +p.hour, mm: +p.minute };
}

/** UTC の時刻 → 日本時間の日付 'YYYY-MM-DD' */
export function dateKey(instant) {
  const { y, m, d } = jstParts(instant);
  return `${y}-${String(m).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
}

/** 'YYYY-MM-DD' に n 日足す（暦の計算だけ。タイムゾーンは関係しない） */
export function addDays(dateStr, n) {
  const [y, m, d] = dateStr.split('-').map(Number);
  return new Date(Date.UTC(y, m - 1, d + n)).toISOString().slice(0, 10);
}

/** 日本時間の日付と時刻 → UTC の時刻 */
export function jstToInstant(dateStr, time = '00:00') {
  return new Date(`${dateStr}T${time}:00${JST_OFFSET}`);
}

/** 「前日18時（日本時間）締め切り」 */
export function deadlineOf(slotStartsAt, { daysBefore = 1, at = '18:00' } = {}) {
  return jstToInstant(addDays(dateKey(slotStartsAt), -daysBefore), at);
}

/** 締め切りの時刻ちょうどからは受け付けない */
export function isBookable(slotStartsAt, now) {
  return now.getTime() < deadlineOf(slotStartsAt).getTime();
}

/** 日本時間のその日の枠を DB から取る範囲 [start, end) */
export function dayRange(dateStr) {
  return { start: jstToInstant(dateStr), end: jstToInstant(addDays(dateStr, 1)) };
}

/** 画面に出す文字列 */
const displayFmt = new Intl.DateTimeFormat('ja-JP', {
  timeZone: TZ, month: 'numeric', day: 'numeric', weekday: 'short', hour: '2-digit', minute: '2-digit',
});
export const formatJst = (instant) => displayFmt.format(instant);

== TZ=UTC
PostgreSQL 18.3 (PGlite 0.5.8) on wasm32-unknown-emscripten, compiled by emcc (Emscripten gcc/clang-like replacement + linker emulating GNU ld) 3.1.74 (1092ec30a3fb1d46b1782ff1b4db5094d3d06ae5), 32-bit
範囲で取った10/9の枠: [
  '1:2026-10-08T15:00:00.000Z',
  '2:2026-10-08T23:30:00.000Z',
  '3:2026-10-09T14:30:00.000Z'
]
悪い例 starts_at::date（セッションのTZ=UTCで日付にする）: [ 3, 4 ]
日本時間の日付で集計: [ '2026-10-09=3', '2026-10-10=1' ]
== TZ=Asia/Tokyo
PostgreSQL 18.3 (PGlite 0.5.8) on wasm32-unknown-emscripten, compiled by emcc (Emscripten gcc/clang-like replacement + linker emulating GNU ld) 3.1.74 (1092ec30a3fb1d46b1782ff1b4db5094d3d06ae5), 32-bit
範囲で取った10/9の枠: [
  '1:2026-10-08T15:00:00.000Z',
  '2:2026-10-08T23:30:00.000Z',
  '3:2026-10-09T14:30:00.000Z'
]
悪い例 starts_at::date（セッションのTZ=UTCで日付にする）: [ 3, 4 ]
日本時間の日付で集計: [ '2026-10-09=3', '2026-10-10=1' ]

// temporal.mjs — 同じ判定を Temporal で書いた版（Node 26 以降は組み込み。ここではポリフィルで確認）
import { Temporal } from 'temporal-polyfill';
const TZ = 'Asia/Tokyo';
const toZdt = (instant) => Temporal.Instant.fromEpochMilliseconds(instant.getTime()).toZonedDateTimeISO(TZ);
const toDate = (zdt) => new Date(zdt.epochMilliseconds);

export const dateKey = (instant) => toZdt(instant).toPlainDate().toString();

export function deadlineOf(slotStartsAt, { daysBefore = 1, at = '18:00' } = {}) {
  return toDate(
    toZdt(slotStartsAt).toPlainDate()
      .subtract({ days: daysBefore })
      .toZonedDateTime({ timeZone: TZ, plainTime: Temporal.PlainTime.from(at) }),
  );
}

export const isBookable = (slotStartsAt, now) => now.getTime() < deadlineOf(slotStartsAt).getTime();

export function dayRange(dateStr) {
  const day = Temporal.PlainDate.from(dateStr);
  return {
    start: toDate(day.toZonedDateTime(TZ)),                       // その日の最初の時刻
    end: toDate(day.add({ days: 1 }).toZonedDateTime(TZ)),
  };
}

$ IMPL=temporal TZ=UTC node --test booking-time.test.mjs
ℹ pass 7
ℹ fail 0

$ IMPL=temporal TZ=America/Los_Angeles node --test booking-time.test.mjs
ℹ pass 7
ℹ fail 0

// booking-time.test.mjs — 境界を固定したテスト。IMPL=naive で古い書き方を試す
import { test } from 'node:test';
import assert from 'node:assert/strict';

const impl = await import(({ naive: './naive.mjs', temporal: './temporal.mjs' })[process.env.IMPL] ?? './jst.mjs');
const T = (iso) => new Date(iso); // テストの時刻は必ずオフセット付きで書く

test('UTC 14:59:59 は日本時間の同じ日、15:00 からは翌日', () => {
  assert.equal(impl.dateKey(T('2026-10-08T14:59:59Z')), '2026-10-08');
  assert.equal(impl.dateKey(T('2026-10-08T15:00:00Z')), '2026-10-09');
});

test('前日18時の締め切り：17:59:59 は受け付け、18:00:00 からは締め切り', () => {
  const slot = T('2026-10-10T11:00:00+09:00');
  assert.equal(impl.isBookable(slot, T('2026-10-09T17:59:59+09:00')), true);
  assert.equal(impl.isBookable(slot, T('2026-10-09T18:00:00+09:00')), false);
});

test('朝9時より前の枠（UTC では前の日）でも、前日は日本時間で数える', () => {
  const slot = T('2026-10-10T08:30:00+09:00'); // = 2026-10-09T23:30Z
  assert.equal(impl.deadlineOf(slot).toISOString(), T('2026-10-09T18:00:00+09:00').toISOString());
});

test('月末をまたぐ：11月1日の枠の締め切りは10月31日18時', () => {
  const slot = T('2026-11-01T10:00:00+09:00');
  assert.equal(impl.deadlineOf(slot).toISOString(), T('2026-10-31T18:00:00+09:00').toISOString());
});

test('年をまたぐ：1月1日の枠の締め切りは12月31日18時', () => {
  const slot = T('2027-01-01T10:00:00+09:00');
  assert.equal(impl.deadlineOf(slot).toISOString(), T('2026-12-31T18:00:00+09:00').toISOString());
});

test('うるう年：2028年3月1日の前日は2月29日、2027年は2月28日', () => {
  assert.equal(impl.deadlineOf(T('2028-03-01T08:30:00+09:00')).toISOString(), T('2028-02-29T18:00:00+09:00').toISOString());
  assert.equal(impl.deadlineOf(T('2027-03-01T08:30:00+09:00')).toISOString(), T('2027-02-28T18:00:00+09:00').toISOString());
});

test('日本時間の「10月9日の枠」を取る範囲は UTC 10/8 15:00 〜 10/9 15:00', () => {
  const { start, end } = impl.dayRange('2026-10-09');
  assert.equal(start.toISOString(), '2026-10-08T15:00:00.000Z');
  assert.equal(end.toISOString(), '2026-10-09T15:00:00.000Z');
});

import { test } from 'node:test';
import assert from 'node:assert/strict';
import { formatJst } from './jst.mjs';
test('表示は日本時間（サーバーの TZ に関係なく）', () => {
  assert.equal(formatJst(new Date('2026-10-09T23:30:00Z')), '10/10(土) 08:30');
});

$ TZ=UTC node --test booking-time.test.mjs
✔ UTC 14:59:59 は日本時間の同じ日、15:00 からは翌日
✔ 前日18時の締め切り：17:59:59 は受け付け、18:00:00 からは締め切り
✔ 朝9時より前の枠（UTC では前の日）でも、前日は日本時間で数える
✔ 月末をまたぐ：11月1日の枠の締め切りは10月31日18時
✔ 年をまたぐ：1月1日の枠の締め切りは12月31日18時
✔ うるう年：2028年3月1日の前日は2月29日、2027年は2月28日
✔ 日本時間の「10月9日の枠」を取る範囲は UTC 10/8 15:00 〜 10/9 15:00
ℹ pass 7
ℹ fail 0

$ TZ=Asia/Tokyo node --test booking-time.test.mjs
ℹ pass 7
ℹ fail 0

$ TZ=America/Los_Angeles node --test booking-time.test.mjs
ℹ pass 7
ℹ fail 0

{
  "scripts": {
    "test": "TZ=UTC node --test && TZ=America/Los_Angeles node --test"
  }
}

// db-check.mjs — PostgreSQL（PGlite）で、timestamptz に入れた時刻と日本時間の日付の扱いを確かめる
import { PGlite } from '@electric-sql/pglite';
import { dayRange } from './jst.mjs';

const db = new PGlite();
console.log((await db.query('SELECT version()')).rows[0].version);
await db.exec(`
  SET TIME ZONE 'UTC';  -- サーバーやクラウドの既定が UTC の想定
  CREATE TABLE slots (
    id        serial PRIMARY KEY,
    starts_at timestamptz NOT NULL,   -- 時刻そのもの（内部は UTC）
    capacity  int NOT NULL
  );
  INSERT INTO slots (starts_at, capacity) VALUES
    ('2026-10-09 00:00:00+09', 2),     -- 日本時間 10/9 の0時ちょうど
    ('2026-10-09 08:30:00+09', 2),     -- UTC ではまだ 10/8
    ('2026-10-09 23:30:00+09', 2),
    ('2026-10-10 00:00:00+09', 2);     -- 翌日。含めてはいけない
`);

const { start, end } = dayRange('2026-10-09');
const r1 = await db.query(
  `SELECT id, starts_at FROM slots WHERE starts_at >= $1 AND starts_at < $2 ORDER BY starts_at`,
  [start.toISOString(), end.toISOString()],
);
console.log('範囲で取った10/9の枠:', r1.rows.map((r) => `${r.id}:${r.starts_at.toISOString()}`));

const r2 = await db.query(
  `SELECT id FROM slots WHERE starts_at::date = '2026-10-09' ORDER BY starts_at`,
);
console.log('悪い例 starts_at::date（セッションのTZ=UTCで日付にする）:', r2.rows.map((r) => r.id));

const r3 = await db.query(`
  SELECT (starts_at AT TIME ZONE 'Asia/Tokyo')::date::text AS jst_date, count(*)::int AS n
    FROM slots GROUP BY 1 ORDER BY 1`);
console.log('日本時間の日付で集計:', r3.rows.map((r) => `${r.jst_date}=${r.n}`));