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