format-ui-display

UI表示用の日付、enum値をフォーマットします。日本語形式の日付、相対日付が必要な場合に使用します。

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The format-ui-display skill is a specialized utility designed to streamline the formatting of dates and enum values for user interfaces. It excels in localizing data for Japanese applications, providing seamless conversion for Japanese-style dates, relative time expressions (e.g., '5 minutes ago'), and human-readable labels for internal enum values, ensuring a consistent and professional UI/UX.

Use Cases

  • Case 1: Converting standard ISO timestamps into localized Japanese date formats (e.g., YYYY年M月D日) for display in administrative tables and user profiles.
  • Case 2: Implementing dynamic relative date labels such as '3 days ago' or 'just now' to improve the readability of activity logs and notification feeds.
  • Case 3: Transforming backend enum values (like 'ADMIN' or 'PENDING') into user-friendly Japanese labels for UI components like badges, status indicators, and dropdowns.
  • Case 4: Standardizing date and time presentation across various application views, including detail screens and summary dashboards, to maintain visual consistency.
nameformat-ui-display
descriptionUI表示用の日付、enum値をフォーマットします。日本語形式の日付、相対日付が必要な場合に使用します。

UI表示フォーマットスキル

データを適切な形式でUI表示するためのスキルです。日付フォーマットとenumラベル変換を提供します。

いつ使うか

このスキルは以下の場合に使用してください:

  • テーブル・詳細画面で日付を表示する
  • 相対的な日付表示(「5分前」「3日前」など)を実装する
  • enum値(権限、ステータス、カテゴリ)を日本語ラベルに変換する
  • Badge やその他のUIコンポーネントでラベル表示する

クイックスタート

日付フォーマット

import { formatDate } from '@repo/utils/format-date'

// 一覧画面
export function UsersTable({ users }: { users: User[] }) {
  return (
    <TableRow>
      <TableCell>{formatDate(user.createdAt, 'YYYY年M月D日')}</TableCell>
    </TableRow>
  )
}

// 詳細画面
export function UserDetail({ user }: { user: User }) {
  return (
    <div>
      <Label>作成日</Label>
      <p>{formatDate(user.createdAt, 'YYYY年M月D日 HH:mm')}</p>
    </div>
  )
}

詳細パターン

詳細な実装パターンについては references を参照してください:

  • date-formatting.md - 日付フォーマットの詳細オプション、相対表示、カスタムフォーマット