FormatRelativeTimeFromDate

Data Display

두 날짜의 차이를 로케일에 맞춰 상대 시간으로 표시하는 Format 컴포넌트.

Usage

기준 날짜와 대상 날짜 사이를 “2일 전”처럼 표시할 때 사용한다.

import

import { FormatRelativeTimeFromDate } from '@mildang/design-system/Format';

API Reference

FormatRelativeTimeFromDate Props

Prop

Type

Default

value

필수

string | number | Date

지정 안 함

locale

string

지정 안 함

now

string | number | Date

지정 안 함

options

RelativeTimeFormatOptions

지정 안 함

showSeconds

boolean

지정 안 함

같은 패밀리

@mildang/design-system/Format 에서 같이 내보내는 컴포넌트다.

FormatDateTime

날짜·숫자·기간을 로케일에 맞춰 표시하는 대표 포맷터.

FormatDateTimeRange

시작·종료 일시를 로케일에 맞춰 표시하는 Format 컴포넌트.

FormatDayOfWeek

날짜의 요일을 로케일에 맞춰 표시하는 Format 컴포넌트.

FormatDuration

ISO-8601 duration을 로케일에 맞춰 표시하는 Format 컴포넌트.

FormatFileSize

바이트 수를 로케일에 맞춰 파일 크기로 표시하는 Format 컴포넌트.

FormatNumber

숫자를 로케일에 맞춰 표시하는 Format 컴포넌트.

FormatPhoneNumber

전화번호를 국가별 형식에 맞춰 표시하는 Format 컴포넌트.

FormatRelativeTime

상대 시간을 로케일에 맞춰 표시하는 Format 컴포넌트.

예제

기본 사용

코드

Open in Playground

import { FormatRelativeTimeFromDate } from '@mildang/design-system/Format';
import { HStack } from '@mildang/styled-system/jsx';

export default function Example() {
  return (
    <HStack flexWrap="wrap" justifyContent="center" gap="8">
      <FormatRelativeTimeFromDate now="2026-09-04T09:00:00.000Z" value="2026-09-01T09:00:00.000Z" />
    </HStack>
  );
}