formatDate / timestampToTime

تاریخ را با الگویی از نشانه‌ها می‌آراید.

API

formatDate(value?, pattern?)

اگر ورودی تجزیه‌شدنی نباشد، 'Invalid Date' برمی‌گرداند.

timestampToTime(timestamp?)

منسوخ است. یک Date برمی‌گرداند که متد format به نمونه‌اش چسبانده شده است.

نمونه

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 ۲۴ساعته است و hh ۱۲ساعته.
2. الگو در یک گذر جایگزین می‌شود، پس مقداری که تازه نوشته شده هرگز به دام نشانه‌ای پس از آن نمی‌افتد.
3. متن عینی را در [] بگذارید تا حرف‌هایش از جایگزینی کنار بمانند.