TIP
이 문서는 AI로 번역되었습니다. 부정확한 내용이 있을 경우 영어 버전을 참조하세요
날짜 형식 지정
구문 설명
날짜를 지정된 형식으로 지정합니다. 출력 형식 patternOut과 선택적 입력 형식 patternIn을 받습니다(patternIn은 기본적으로 ISO 8601입니다). options.timezone 및 options.lang을 통해 시간대와 언어를 조정할 수 있습니다.
예시
// 예시 환경: API 옵션 { "lang": "en-us", "timezone": "Europe/Paris" }
'20160131':formatD(L) // 결과 01/31/2016
'20160131':formatD(LL) // 결과 January 31, 2016
'20160131':formatD(LLLL) // 결과 Sunday, January 31, 2016 12:00 AM
'20160131':formatD(dddd) // 결과 Sunday
// 프랑스어 예시:
'2017-05-10T15:57:23.769561+03:00':formatD(LLLL) // 결과 mercredi 10 mai 2017 14:57
'20160131':formatD(LLLL) // 결과 dimanche 31 janvier 2016 00:00
1410715640:formatD(LLLL, X) // 결과 dimanche 14 septembre 2014 19:27
결과
지정된 형식으로 지정된 날짜 문자열이 출력됩니다.
2. :addD(amount, unit, patternIn)
구문 설명
날짜에 지정된 시간량을 추가합니다. 지원되는 단위는 day, week, month, quarter, year, hour, minute, second, millisecond입니다.
매개변수:
amount: 추가할 수량
unit: 시간 단위 (대소문자 구분 없음)
patternIn: 선택 사항, 입력 형식 (기본값은 ISO8601)
예시
// 예시 환경: API 옵션 { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':addD('3', 'day') // 결과 "2017-05-13T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':addD('3', 'month') // 결과 "2017-08-10T12:57:23.769Z"
'20160131':addD('3', 'day') // 결과 "2016-02-03T00:00:00.000Z"
'20160131':addD('3', 'month') // 결과 "2016-04-30T00:00:00.000Z"
'31-2016-01':addD('3', 'month', 'DD-YYYY-MM') // 결과 "2016-04-30T00:00:00.000Z"
결과
지정된 시간을 추가한 새로운 날짜가 출력됩니다.
3. :subD(amount, unit, patternIn)
구문 설명
날짜에서 지정된 시간량을 뺍니다. 매개변수는 addD와 동일합니다.
예시
// 예시 환경: API 옵션 { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':subD('3', 'day') // 결과 "2017-05-07T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':subD('3', 'month') // 결과 "2017-02-10T12:57:23.769Z"
'20160131':subD('3', 'day') // 결과 "2016-01-28T00:00:00.000Z"
'20160131':subD('3', 'month') // 결과 "2015-10-31T00:00:00.000Z"
'31-2016-01':subD('3', 'month', 'DD-YYYY-MM') // 결과 "2015-10-31T00:00:00.000Z"
결과
지정된 시간을 뺀 새로운 날짜가 출력됩니다.
4. :startOfD(unit, patternIn)
구문 설명
날짜를 지정된 시간 단위의 시작 시점으로 설정합니다.
매개변수:
unit: 시간 단위
patternIn: 선택 사항, 입력 형식
예시
// 예시 환경: API 옵션 { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':startOfD('day') // 결과 "2017-05-10T00:00:00.000Z"
'2017-05-10 15:57:23.769561+03:00':startOfD('month') // 결과 "2017-05-01T00:00:00.000Z"
'20160131':startOfD('day') // 결과 "2016-01-31T00:00:00.000Z"
'20160131':startOfD('month') // 결과 "2016-01-01T00:00:00.000Z"
'31-2016-01':startOfD('month', 'DD-YYYY-MM') // 결과 "2016-01-01T00:00:00.000Z"
결과
지정된 단위의 시작 시점으로 설정된 날짜 문자열이 출력됩니다.
5. :endOfD(unit, patternIn)
구문 설명
날짜를 지정된 시간 단위의 종료 시점으로 설정합니다. 매개변수는 startOfD와 동일합니다.
예시
// 예시 환경: API 옵션 { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':endOfD('day') // 결과 "2017-05-10T23:59:59.999Z"
'2017-05-10 15:57:23.769561+03:00':endOfD('month') // 결과 "2017-05-31T23:59:59.999Z"
'20160131':endOfD('day') // 결과 "2016-01-31T23:59:59.999Z"
'20160131':endOfD('month') // 결과 "2016-01-31T23:59:59.999Z"
'31-2016-01':endOfD('month', 'DD-YYYY-MM') // 결과 "2016-01-31T23:59:59.999Z"
결과
지정된 단위의 종료 시점으로 설정된 날짜 문자열이 출력됩니다.
6. :diffD(toDate, unit, patternFromDate, patternToDate)
구문 설명
두 날짜 간의 차이를 계산하고 지정된 단위로 출력합니다. 지원되는 출력 단위는 다음과 같습니다.
day(s) 또는 d
week(s) 또는 w
quarter(s) 또는 Q
month(s) 또는 M
year(s) 또는 y
hour(s) 또는 h
minute(s) 또는 m
second(s) 또는 s
millisecond(s) 또는 ms (기본 단위)
매개변수:
toDate: 대상 날짜
unit: 출력 단위
patternFromDate: 선택 사항, 시작 날짜 형식
patternToDate: 선택 사항, 대상 날짜 형식
예시
'20101001':diffD('20101201') // 결과 5270400000
'20101001':diffD('20101201', 'second') // 결과 5270400
'20101001':diffD('20101201', 's') // 결과 5270400
'20101001':diffD('20101201', 'm') // 결과 87840
'20101001':diffD('20101201', 'h') // 결과 1464
'20101001':diffD('20101201', 'weeks') // 결과 8
'20101001':diffD('20101201', 'days') // 결과 61
'2010+10+01':diffD('2010=12=01', 'ms', 'YYYY+MM+DD', 'YYYY=MM=DD') // 결과 5270400000
결과
두 날짜 간의 시간 차이가 지정된 단위로 변환되어 출력됩니다.
7. :convDate(patternIn, patternOut)
구문 설명
날짜를 한 형식에서 다른 형식으로 변환합니다. (사용을 권장하지 않습니다.)
매개변수:
patternIn: 입력 날짜 형식
patternOut: 출력 날짜 형식
예시
// 예시 환경: API 옵션 { "lang": "en", "timezone": "Europe/Paris" }
'20160131':convDate('YYYYMMDD', 'L') // 결과 "01/31/2016"
'20160131':convDate('YYYYMMDD', 'LL') // 결과 "January 31, 2016"
'20160131':convDate('YYYYMMDD', 'LLLL') // 결과 "Sunday, January 31, 2016 12:00 AM"
'20160131':convDate('YYYYMMDD', 'dddd') // 결과 "Sunday"
1410715640:convDate('X', 'LLLL') // 결과 "Sunday, September 14, 2014 7:27 PM"
// 프랑스어 예시:
'20160131':convDate('YYYYMMDD', 'LLLL') // 결과 "dimanche 31 janvier 2016 00:00"
'20160131':convDate('YYYYMMDD', 'dddd') // 결과 "dimanche"
결과
변환된 날짜 문자열이 출력됩니다.
8. 날짜 형식 패턴
날짜 형식 패턴 (DayJS 문서 참조):
X: Unix 타임스탬프 (초), 예: 1360013296
x: Unix 밀리초 타임스탬프, 예: 1360013296123
YY: 두 자리 연도, 예: 18
YYYY: 네 자리 연도, 예: 2018
M, MM, MMM, MMMM: 월 (숫자, 두 자리, 약어, 전체 이름)
D, DD: 일 (숫자, 두 자리)
d, dd, ddd, dddd: 요일 (숫자, 최소, 약어, 전체 이름)
H, HH, h, hh: 시간 (24시간제 또는 12시간제)
m, mm: 분
s, ss: 초
SSS: 밀리초 (3자리)
Z, ZZ: UTC 오프셋, 예: +05:00 또는 +0500
A, a: 오전/오후
Q: 분기 (1-4)
Do: 서수 접미사가 붙은 날짜, 예: 1st, 2nd, …
- 기타 형식은 전체 문서를 참조하십시오.
- 또한,
LT, LTS, L, LL, LLL, LLLL 등 언어 기반의 현지화된 형식도 있습니다.