会計年度（第何期か）の計算

<?php
declare(strict_types=1);

/**
 * 会計年度（第何期か）の計算。
 * v2: 月の通し番号（年×12＋月−1）で数え、DateTime の繰り越しに頼らない。
 * 存在しない日付は checkdate() で invalid_date にする（new DateTime('2025-02-30') は 3月2日に繰り越すため）。
 */
function monthIndex(int $y, int $m): int
{
    return $y * 12 + ($m - 1);
}

function firstClosingAtOrAfter(int $idx, int $closingMonth): int
{
    return $idx + ((($closingMonth - 1 - $idx % 12) % 12) + 12) % 12;
}

function ymd(int $idx, bool $last = false): string
{
    $y = intdiv($idx, 12);
    $m = $idx % 12 + 1;
    $d = $last ? (int) (new DateTimeImmutable(sprintf('%04d-%02d-01', $y, $m)))->format('t') : 1;
    return sprintf('%04d-%02d-%02d', $y, $m, $d);
}

/** @return array<string, int|string> */
function calcFiscal(int $closingMonth, string $start, string $date): array
{
    if (!preg_match('/^(\d{4})-(\d{2})-(\d{2})$/', $date, $mm) || !checkdate((int) $mm[2], (int) $mm[3], (int) $mm[1])) {
        return ['error' => 'invalid_date'];
    }
    [$sy, $sm] = array_map('intval', explode('-', $start));
    $s = monthIndex($sy, $sm);
    $t = monthIndex((int) $mm[1], (int) $mm[2]);
    if ($t < $s) {
        return ['error' => 'before_start'];
    }
    $firstClose = firstClosingAtOrAfter($s, $closingMonth);
    $close = firstClosingAtOrAfter($t, $closingMonth);
    $n = intdiv($close - $firstClose, 12) + 1;
    return ['period' => $n, 'start' => ymd($n === 1 ? $s : $close - 11), 'end' => ymd($close, true), 'next_start' => ymd($close + 1)];
}

<?php
declare(strict_types=1);

/**
 * 会計年度（第何期か）の計算。
 * v1: よくある書き方（DateTimeImmutable で日付を読み、期首を「決算月の翌月1日」として作る）。
 */
function fiscalStart(DateTimeImmutable $d, int $closingMonth): DateTimeImmutable
{
    $y = (int) $d->format('Y');
    $year = (int) $d->format('n') > $closingMonth ? $y : $y - 1;
    return (new DateTimeImmutable())->setDate($year, $closingMonth + 1, 1)->setTime(0, 0);
}

/** @return array<string, int|string> */
function calcFiscal(int $closingMonth, string $start, string $date): array
{
    $d = new DateTimeImmutable($date);
    $s = new DateTimeImmutable($start . '-01');
    if ($d < $s) {
        return ['error' => 'before_start'];
    }
    $fy = fiscalStart($d, $closingMonth);
    $first = fiscalStart($s, $closingMonth);
    $n = (int) $fy->format('Y') - (int) $first->format('Y') + 1;
    $next = $fy->modify('+1 year');
    return [
        'period' => $n,
        'start' => ($n === 1 ? $s : $fy)->format('Y-m-d'),
        'end' => $next->modify('-1 day')->format('Y-m-d'),
        'next_start' => $next->format('Y-m-d'),
    ];
}

"""会計年度（第何期か）の計算。

v2: 月の通し番号（年×12＋月−1）で数え、date の繰り越しに頼らない。
存在しない日付は invalid_date にする（「13月」を作らない。決算月12月でも落ちない）。
"""
import calendar
from datetime import date


def _month_index(y: int, m: int) -> int:
    return y * 12 + (m - 1)


def _first_closing_at_or_after(idx: int, closing_month: int) -> int:
    return idx + (closing_month - 1 - idx % 12) % 12


def _ymd(idx: int, last: bool = False) -> str:
    y, m0 = divmod(idx, 12)
    d = calendar.monthrange(y, m0 + 1)[1] if last else 1
    return f"{y:04d}-{m0 + 1:02d}-{d:02d}"


def calc_fiscal(closing_month: int, start: str, date_str: str) -> dict:
    try:
        d = date.fromisoformat(date_str)  # 2月30日などは ValueError になる（繰り越さない）
    except ValueError:
        return {"error": "invalid_date"}
    sy, sm = map(int, start.split("-"))
    s, t = _month_index(sy, sm), _month_index(d.year, d.month)
    if t < s:
        return {"error": "before_start"}
    first_close = _first_closing_at_or_after(s, closing_month)
    close = _first_closing_at_or_after(t, closing_month)
    n = (close - first_close) // 12 + 1
    return {"period": n, "start": _ymd(s if n == 1 else close - 11), "end": _ymd(close, last=True), "next_start": _ymd(close + 1)}

"""会計年度（第何期か）の計算。

v1: よくある書き方（datetime で日付を読み、期首を「決算月の翌月1日」として date を作る）。
"""
from datetime import date, timedelta


def fiscal_start(d: date, closing_month: int) -> date:
    """d が属する事業年度の期首（決算月の翌月1日）。"""
    if d.month > closing_month:
        return date(d.year, closing_month + 1, 1)
    return date(d.year - 1, closing_month + 1, 1)


def calc_fiscal(closing_month: int, start: str, date_str: str) -> dict:
    d = date.fromisoformat(date_str)
    s = date.fromisoformat(start + "-01")
    if d < s:
        return {"error": "before_start"}
    fy = fiscal_start(d, closing_month)
    first = fiscal_start(s, closing_month)
    n = fy.year - first.year + 1
    next_start = date(fy.year + 1, fy.month, 1)
    return {"period": n, "start": (s if n == 1 else fy).isoformat(),
            "end": (next_start - timedelta(days=1)).isoformat(), "next_start": next_start.isoformat()}

package main

import (
	"fmt"
	"time"
)

// v2: 月の通し番号（年×12＋月−1）で数え、time.Date の繰り越しを結果に出さない。
// 存在しない日付は time.Parse がエラーにするので、それを invalid_date として返す（エラーで止めない）。
func monthIndex(y, m int) int { return y*12 + (m - 1) }

func firstClosingAtOrAfter(idx, closingMonth int) int {
	return idx + ((closingMonth-1-idx%12)%12+12)%12
}

func ymd(idx int, last bool) string {
	y, m := idx/12, idx%12+1
	d := 1
	if last {
		d = time.Date(y, time.Month(m)+1, 0, 0, 0, 0, 0, time.UTC).Day() // 翌月0日＝その月の末日
	}
	return fmt.Sprintf("%04d-%02d-%02d", y, m, d)
}

// CalcFiscal は判定日が第何期かを求める。
func CalcFiscal(closingMonth int, start, date string) (map[string]any, error) {
	d, err := time.Parse("2006-01-02", date)
	if err != nil {
		return map[string]any{"error": "invalid_date"}, nil
	}
	var sy, sm int
	if _, err := fmt.Sscanf(start, "%d-%d", &sy, &sm); err != nil {
		return nil, err
	}
	s, t := monthIndex(sy, sm), monthIndex(d.Year(), int(d.Month()))
	if t < s {
		return map[string]any{"error": "before_start"}, nil
	}
	firstClose := firstClosingAtOrAfter(s, closingMonth)
	closeIdx := firstClosingAtOrAfter(t, closingMonth)
	n := (closeIdx-firstClose)/12 + 1
	startIdx := closeIdx - 11
	if n == 1 {
		startIdx = s
	}
	return map[string]any{"period": n, "start": ymd(startIdx, false), "end": ymd(closeIdx, true), "next_start": ymd(closeIdx+1, false)}, nil
}

package main

import "time"

// v1: よくある書き方（time.Parse で日付を読み、期首を「決算月の翌月1日」として time.Date で作る）。
func fiscalStart(d time.Time, closingMonth int) time.Time {
	y := d.Year()
	if int(d.Month()) <= closingMonth {
		y--
	}
	return time.Date(y, time.Month(closingMonth+1), 1, 0, 0, 0, 0, time.UTC)
}

// CalcFiscal は判定日が第何期かを求める。
func CalcFiscal(closingMonth int, start, date string) (map[string]any, error) {
	d, err := time.Parse("2006-01-02", date)
	if err != nil {
		return nil, err
	}
	s, err := time.Parse("2006-01-02", start+"-01")
	if err != nil {
		return nil, err
	}
	if d.Before(s) {
		return map[string]any{"error": "before_start"}, nil
	}
	fy := fiscalStart(d, closingMonth)
	first := fiscalStart(s, closingMonth)
	n := fy.Year() - first.Year() + 1
	next := fy.AddDate(1, 0, 0)
	periodStart := fy
	if n == 1 {
		periodStart = s
	}
	return map[string]any{
		"period": n, "start": periodStart.Format("2006-01-02"),
		"end": next.AddDate(0, 0, -1).Format("2006-01-02"), "next_start": next.Format("2006-01-02"),
	}, nil
}

// 会計年度（第何期か）の計算。
// v2: 月の通し番号（年×12＋月−1）で数え、Date の繰り越しとタイムゾーンを通さない。
// 存在しない日付は invalid_date にする（new Date(2025, 1, 30) は 3月2日に繰り越すので使わない）。

const monthIndex = (y, m) => y * 12 + (m - 1);
const firstClosingAtOrAfter = (idx, closingMonth) => idx + ((((closingMonth - 1 - (idx % 12)) % 12) + 12) % 12);
// その月の日数。Date.UTC はタイムゾーンの影響を受けない
const daysInMonth = (y, m) => new Date(Date.UTC(y, m, 0)).getUTCDate();
const pad = (n, w) => String(n).padStart(w, "0");

function ymd(idx, last = false) {
  const y = Math.floor(idx / 12);
  const m = (idx % 12) + 1;
  return `${pad(y, 4)}-${pad(m, 2)}-${pad(last ? daysInMonth(y, m) : 1, 2)}`;
}

export function calcFiscal({ closing_month, start, date }) {
  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
  if (!m) return { error: "invalid_date" };
  const [y, mo, d] = m.slice(1).map(Number);
  if (mo < 1 || mo > 12 || d < 1 || d > daysInMonth(y, mo)) return { error: "invalid_date" };
  const [sy, sm] = start.split("-").map(Number);
  const s = monthIndex(sy, sm);
  const t = monthIndex(y, mo);
  if (t < s) return { error: "before_start" };
  const firstClose = firstClosingAtOrAfter(s, closing_month);
  const close = firstClosingAtOrAfter(t, closing_month);
  const n = (close - firstClose) / 12 + 1;
  return { period: n, start: ymd(n === 1 ? s : close - 11), end: ymd(close, true), next_start: ymd(close + 1) };
}

// 会計年度（第何期か）の計算。
// v1: よくある書き方（Date で日付を読み、期首を「決算月の翌月1日」として new Date で作る。文字列化は toISOString）。

function fiscalStart(d, closingMonth) {
  // getMonth() は 0 始まり。決算月の翌月 = closingMonth（0 始まりの値として）
  if (d.getMonth() + 1 > closingMonth) return new Date(d.getFullYear(), closingMonth, 1);
  return new Date(d.getFullYear() - 1, closingMonth, 1);
}

const fmt = (d) => d.toISOString().slice(0, 10);

export function calcFiscal({ closing_month, start, date }) {
  const [y, m, dd] = date.split("-").map(Number);
  const d = new Date(y, m - 1, dd);
  const [sy, sm] = start.split("-").map(Number);
  const s = new Date(sy, sm - 1, 1);
  if (d < s) return { error: "before_start" };
  const fy = fiscalStart(d, closing_month);
  const first = fiscalStart(s, closing_month);
  const n = fy.getFullYear() - first.getFullYear() + 1;
  const next = new Date(fy.getFullYear() + 1, fy.getMonth(), 1);
  const end = new Date(next.getFullYear(), next.getMonth(), 0);
  return { period: n, start: fmt(n === 1 ? s : fy), end: fmt(end), next_start: fmt(next) };
}