formatDate / timestampToTime

トークンのパターンで日付を整形します。

API

formatDate(value?, pattern?)

パラメーター 説明 既定値
value タイムスタンプ、日付の文字列、Date。省くと現在時刻 number | string | Date 現在時刻
pattern トークンのパターン string 'YYYY-MM-DD HH:mm:ss'
トークン 意味 トークン 意味
YYYY/YY mm/m
MM/M 月(1〜12) ss/s
DD/D SSS ミリ秒
HH/H 時(0〜23) A/a AM/PM・am/pm
hh/h 時(1〜12) [...] そのまま出す文字

入力を解析できないときは 'Invalid Date' を返します。

timestampToTime(timestamp?)

非推奨です。インスタンスに format メソッドを生やした Date を返します。

使用例

import { formatDate } from 'ranuts';

formatDate(); // '2026-07-25 14:30:00'
formatDate(1753425000000, 'YYYY/MM/DD'); // '2026/07/25'
formatDate(new Date(), 'YYYY[年]MM[月]DD[日] hh:mm a');
formatDate('not a date'); // 'Invalid Date'

補足

  1. 大文字と小文字は別ものです。 MM は月、mm は分。HH は 24 時間制、hh は 12 時間制です。
  2. パターンの置換は一度で済ませます。 ですから、書き込んだばかりの値が、あとのトークンにもう一度拾われることはありません。
  3. そのまま出したい文字は [] で囲んで、置換の対象から外してください。