duration

주어진 밀리초 값을 사람이 읽을 수 있는 시간으로 표시합니다. 예를 들어, 604800000(7일)의 값은 7 Days로 표시됩니다.

한 달은 30일, 1년은 365일을 기준으로 계산합니다.

단위 이름은 영어이고 복수형은 s를 붙이는데, 이렇게 복수형을 만드는 언어는 영어뿐입니다. 다른 언어로 시간을 쓰려면 durationParts로 쪼갠 다음, 그 언어를 아는 포매터에 넘기세요.

Parameters

이름	타입	필수	기본값
milliseconds	numbernumfloat	●	–
변환할 시간(밀리초)입니다.
optionsnamedkeyword	DurationOptions	–	–
포맷 옵션입니다. 아래 표를 참고하세요.

named이 파라미터는 named 파라미터로 전달합니다.

keyword이 파라미터는 키워드 인자로 전달하거나, 대신 dict 하나로 전달합니다.

DurationOptions

이름	타입	필수	기본값
useShortString	booleanbool	–	falseFalse
단위를 축약형으로 표시합니다: Years→Y, Months→Mo, Days→D, Hours→H, Minutes→M, Seconds→S, Milliseconds→ms. (Months는 Minutes(M)와 겹치지 않도록 Mo를 사용합니다.)
useSpace	booleanbool	–	trueTrue
값과 단위 사이에 공백을 넣습니다. (예: 1Days → 1 Days)
withZeroValue	booleanbool	–	falseFalse
가장 큰 단위 아래에 있는, 값이 0인 단위도 포함합니다. (예: 1 Day 0 Hours 0 Minutes 0 Seconds)
separator	stringStringstr	–	' '
단위 사이에 넣을 구분자입니다. (예: -이면 1 Hour-10 Minutes)
withMilliSeconds	booleanbool	–	falseFalse
밀리초 단위를 포함합니다. falseFalse인 경우 1초 미만의 값은 생략됩니다.
maxUnitCount	numberint	–	–
표시할 최대 단위 개수이며, 가장 큰 단위부터 셉니다. 생략하면 제한이 없습니다.
unit	stringStringstr	–	–
전체 시간을 하나의 단위로만 표시하며, 소수점 값을 허용합니다. (예: Hour → 48 Hours, 0.5 Hours) Year, Month, Day, Hour, Minute, Second, Millisecond 중 하나입니다.

Returns

string

String

str

Examples

duration(1234567890); // Returns '14 Days 6 Hours 56 Minutes 7 Seconds'
duration(1234567890, {
	withMilliSeconds: true
}); // Returns '14 Days 6 Hours 56 Minutes 7 Seconds 890 Milliseconds'
duration(34560000000); // Returns '1 Year 1 Month 5 Days'
duration(34560000000, {
	maxUnitCount: 2
}); // Returns '1 Year 1 Month'
duration(172800000, {
	unit: 'Hour'
}); // Returns '48 Hours'
duration(1800000, {
	unit: 'Hour'
}); // Returns '0.5 Hours'
duration(604800000, {
	useSpace: false
}); // Returns '7Days'

duration(1234567890); // Returns '14 Days 6 Hours 56 Minutes 7 Seconds'
duration(1234567890, withMilliSeconds: true); // Returns '14 Days 6 Hours 56 Minutes 7 Seconds 890 Milliseconds'
duration(34560000000); // Returns '1 Year 1 Month 5 Days'
duration(34560000000, maxUnitCount: 2); // Returns '1 Year 1 Month'
duration(172800000, unit: 'Hour'); // Returns '48 Hours'
duration(1800000, unit: 'Hour'); // Returns '0.5 Hours'
duration(604800000, useSpace: false); // Returns '7Days'

duration(1234567890)  # Returns '14 Days 6 Hours 56 Minutes 7 Seconds'
duration(1234567890, {
	'withMilliSeconds': True
})  # Returns '14 Days 6 Hours 56 Minutes 7 Seconds 890 Milliseconds'
duration(34560000000)  # Returns '1 Year 1 Month 5 Days'
duration(34560000000, {
	'maxUnitCount': 2
})  # Returns '1 Year 1 Month'
duration(172800000, {
	'unit': 'Hour'
})  # Returns '48 Hours'
duration(1800000, {
	'unit': 'Hour'
})  # Returns '0.5 Hours'
duration(604800000, {
	'useSpace': False
})  # Returns '7Days'