最近は Intl.DateTimeFormat がとても便利なので紹介します。

`Intl.DateTimeFormat` とは

Intl.DateTimeFormat は Date を任意の文字列フォーマットに変換する為のクラスです。

通常は format(date) でフォーマットします。

ただ、必要なフォーマットが存在しない！今回はそういうときの話です。

`formatToParts(date)` の使い方

formatToParts(date) という部品単位でどういう部品であるかの情報をつけて出力してくれるものがあります。

つまり、必要な部品を用意してくれるのです。

const from = new Date();
const options: Intl.DateTimeFormatOptions = {
  year: "numeric",
  month: "2-digit",
  day: "2-digit",
  hour: "2-digit",
  minute: "2-digit",
  second: "2-digit",
  calendar: "iso8601",
  fractionalSecondDigits: 3,
  timeZoneName: "shortOffset",
};
const format = new Intl.DateTimeFormat("ja-JP", options);
const { year, month, day, hour, minute, second, fractionalSecond, timeZoneName } = ((parts) => {
  return Object.fromEntries(parts.filter(({ type }) => type !== "literal").map(({ type, value }) => [type, value])) as {
    year: string;
    month: string;
    day: string;
    hour: string;
    minute: string;
    second: string;
    fractionalSecond: string;
    timeZoneName: string;
  };
})(format.formatToParts(from));
const formatted = `${year}-${month}-${day}T${hour}:${minute}:${second}.${fractionalSecond}`;
console.log(formatted);
// -> "2025-01-19T14:04:22.377

これを使いまわすなら次の様な関数を作るとよいでしょう。

const toLocal = makeToLocal();
{
  const date = new Date();
  console.log(`${date.toISOString()} -> ${toLocal(date)}`);
  // -> "2025-01-19T05:06:41.549Z -> 2025-01-19T14:06:41.549"
}
{
  const date = new Date().toISOString();
  console.log(`${date} -> ${toLocal(date)}`);
  // -> "2025-01-19T05:06:41.551Z -> 2025-01-19T14:06:41.551"
}
/**
 * timeZone を local に 変換する
 */
function makeToLocal() {
  let toLocalFormat: Intl.DateTimeFormat | undefined;
  return toLocal;
  /**
   * timeZone が local な 日付文字列を返す
   */
  function toLocal(from: string): string;
  /**
   * timeZone が local な Date を返す
   */
  function toLocal(from: Date): string;
  function toLocal(from: string | Date): string {
    const isString = typeof from === "string";
    if (isString) {
      from = new Date(from as string);
    }
    if (typeof from === "string") throw new Error();
    const { year, month, day, hour, minute, second, fractionalSecond } = ((parts) => {
      return Object.fromEntries(parts.filter(({ type }) => type !== "literal").map(({ type, value }) => [type, value])) as {
        year: string;
        month: string;
        day: string;
        hour: string;
        minute: string;
        second: string;
        fractionalSecond: string;
        timeZoneName: string;
      };
    })((toLocalFormat ??= initial()).formatToParts(from));
    const result = `${year}-${month}-${day}T${hour}:${minute}:${second}.${fractionalSecond}`;
    return result;
    function initial() {
      const options: Intl.DateTimeFormatOptions = {
        year: "numeric",
        month: "2-digit",
        day: "2-digit",
        hour: "2-digit",
        minute: "2-digit",
        second: "2-digit",
        calendar: "iso8601",
        fractionalSecondDigits: 3,
        timeZoneName: "shortOffset",
      };
      return new Intl.DateTimeFormat("ja-JP", options);
    }
  }
}

以上。