RelativeTime

“2주 전” 같은 경과 표기와 <time datetime>.

개요

미리보기

예시 언어동작 줄이기

Oct 19

value

absoluteAfter

exact

timeZone

now

이름	타입	기본값	설명
`value`	`string`	`2026-10-19T09:00:00+09:00`	그 순간. 오프셋을 붙인 ISO.
`absoluteAfter?`	`'7d' \| 'never'`	`7d`	7d는 7일부터 날짜(DateText)로 바꾼다. never는 주·개월로 계속 센다.
`exact?`	`'hidden' \| 'visible'`	`hidden`	정확한 날짜의 자리. hidden은 스크린리더만 읽고, visible은 “2주 전 · 10월 7일”. 툴팁에 두지 않는다.
`timeZone?`	`string`	`Asia/Seoul`	“어제”를 가르는 달력 날짜와 정확한 날짜의 시간대.
`now?`	`string`		고정된 “지금”(ISO). 비우면 앱 전체가 공유하는 1분 시계. 문서가 숨겨지면 멈춘다.
그 밖의 속성	—	—	id, aria-* 등 <span> 속성을 전달한다.

예시

이렇게 · 이렇게 하지 않기

이렇게 경과가 날짜보다 의미 있을 때 쓰고, 정확한 날짜는 툴팁이 아니라 곁에 함께 둔다.

이렇게 단계는 방금, {n}분 전, {n}시간 전, 어제, {n}일 전, {n}주 전 순이다.

이렇게 하지 않기 자동 갱신은 보조기기에 알리지 않는다.

토큰과 속성

이름	타입	기본값	설명
`value`	`string`	`2026-10-19T09:00:00+09:00`	그 순간. 오프셋을 붙인 ISO.
`absoluteAfter?`	`'7d' \| 'never'`	`7d`	7d는 7일부터 날짜(DateText)로 바꾼다. never는 주·개월로 계속 센다.
`exact?`	`'hidden' \| 'visible'`	`hidden`	정확한 날짜의 자리. hidden은 스크린리더만 읽고, visible은 “2주 전 · 10월 7일”. 툴팁에 두지 않는다.
`timeZone?`	`string`	`Asia/Seoul`	“어제”를 가르는 달력 날짜와 정확한 날짜의 시간대.
`now?`	`string`		고정된 “지금”(ISO). 비우면 앱 전체가 공유하는 1분 시계. 문서가 숨겨지면 멈춘다.
그 밖의 속성	—	—	id, aria-* 등 <span> 속성을 전달한다.