위젯의 날짜 및 시간 형식 지정
날짜 및 시간 형식 문자열 조합을 사용하여 위젯에서 날짜 및 시간 형식을 구성할 수 있습니다. 날짜 및 시간 표현은 로캘 및 컨텍스트에 따라 달라집니다. 형식 지정을 사용하면 매쉬업이 다른 언어로 표시될 때 날짜 및 시간을 로컬리제이션할 수 있습니다. 또한 날짜 선택기 및 값 표시 위젯과 같이 날짜 및 시간을 표시하는 위젯에 대한 날짜 및 시간 표시 방식을 제어하는 데 이 형식 지정을 사용할 수 있습니다. 다음 두 가지 방법 중 하나로 날짜 형식을 지정할 수 있습니다.
• 수동으로 위젯 형식 지정 속성에 형식 입력
• 사용자 로캘을 기반으로 별도의 날짜 형식을 생성하고 사용할 수 있는 로컬리제이션 토큰 사용
지원되는 형식은 Moment.js JavaScript 라이브러리를 기반으로 하며 대/소문자를 구분합니다. 이 라이브러리에 대한 자세한 내용은 다음을 참조하십시오.
다음 항목은 다음 단원으로 나뉩니다.
지원되는 날짜 형식
다음 표에는 사용 가능한 날짜 형식이 나와 있습니다.
 |
다음 목록은 ThingWorx Web Component SDK의 일부로 사용할 수 있는 웹 구성 요소 위젯에 적용됩니다.
|
|
유형
|
형식
|
출력
|
예
|
|---|---|---|---|
|
평일
|
d
|
0에서 6 사이의 범위를 표시합니다. 여기서 0은 일요일이고 6은 토요일입니다.
|
1
|
|
dd
|
일의 첫 두 문자를 표시합니다.
|
Mo
|
|
|
ddd
|
일의 첫 세 문자를 표시합니다.
|
Mon
|
|
|
dddd
|
요일의 전체 이름을 표시합니다.
|
Monday
|
|
|
연도
|
YY
|
연도를 앞에 0이 있는 두 자리 숫자로 표시합니다. 예를 들어, 2009는 09로 표시됩니다.
|
09
|
|
YYYY
|
연도를 네 자리 숫자로 표시합니다.
|
2009
|
|
|
월
|
M
|
월 숫자를 1에서 12 사이의 범위로 표시합니다. 1월은 1이고 12월은 12입니다.
|
1
|
|
Mo
|
월 숫자를 서수 표시기와 함께 1에서 12 사이의 범위로 표시합니다. 1월은 1st이고 12월은 12th입니다.
|
12th
|
|
|
MM
|
월 숫자를 01에서 12 사이의 범위로 표시합니다. 1월은 01이고 12월은 12입니다.
|
01
|
|
|
MMM
|
월을 축약 문자열로 표시합니다.
|
Jan
|
|
|
MMMM
|
전체 월 이름을 문자열(January)로 표시합니다.
|
January
|
|
|
분기
|
Q
|
분기 숫자를 1에서 4 사이의 범위로 표시합니다.
|
2
|
|
Qo
|
분기 숫자를 서수 표시기와 함께 1에서 4 사이의 숫자로 표시합니다.
|
2nd
|
|
|
일
|
D
|
일을 1에서 31 사이의 범위로 표시합니다.
|
30
|
|
Do
|
일을 서수 표시기와 함께 1에서 31 사이의 숫자 범위로 표시합니다. 첫 번째 일은 1st이고 마지막 일은 31st입니다.
|
30th
|
|
|
DD
|
일을 01에서 31 사이의 숫자로 표시합니다.
|
23
|
|
|
연간 일
|
DDD
|
연간 일을 1에서 365 사이의 숫자 범위로 표시합니다.
|
51
|
|
DDDo
|
연간 일을 서수 표시기와 함께 1에서 365 사이의 범위로 표시합니다. 첫 번째 일은 1st이고 마지막 일은 365th입니다.
|
51st
|
|
|
DDDD
|
연간 일을 001에서 365 사이의 숫자 범위로 표시합니다.
|
051
|
|
|
연간 주
|
w
|
현재 주를 1에서 53 사이의 숫자 범위로 표시합니다.
|
42
|
|
wo
|
주 숫자를 서수 표시기와 함께 1에서 53 사이의 숫자 범위로 표시합니다.
|
42nd
|
|
|
ww
|
현재 주를 1에서 53 사이의 숫자 범위로 표시합니다. 10 미만 숫자의 경우 앞에 0이 표시됩니다.
|
01
|
지원되는 시간 형식
다음 표에는 사용 가능한 시간 형식이 나와 있습니다.
|
유형
|
형식
|
출력
|
예
|
|---|---|---|---|
|
24시간 형식
|
H
|
시간을 24시간 형식으로 표시합니다.
|
• 0
• 23
|
|
HH
|
시간을 10 미만 값의 경우 앞에 0이 표시되는 24시간 형식으로 표시합니다.
|
• 00
• 23
|
|
|
12시간 형식
|
h
|
시간을 12시간 형식으로 표시합니다.
|
• 1
• 12
|
|
hh
|
시간을 10 미만 값의 경우 앞에 0이 표시되는 12시간 형식으로 표시합니다.
|
• 01
• 12
|
|
|
분
|
m
|
분을 표시합니다.
|
• 0
• 59
|
|
mm
|
분을 10 미만 값의 경우 앞에 0이 표시되는 두 자리 숫자로 표시합니다.
|
• 00
• 59
|
|
|
초
|
s
|
초를 표시합니다.
|
• 0
• 59
|
|
ss
|
앞에 0이 표시되는 초를 표시합니다.
|
• 00
• 59
|
|
|
AM/PM
|
a
|
12시간 형식을 사용할 때 소문자 AM 및 PM 약어를 표시합니다.
|
• am
• pm
|
|
A
|
12시간 형식을 사용할 때 대문자 AM 및 PM 약어를 표시합니다.
|
• AM
• PM
|
|
|
밀리초
|
SSS
|
1/1000초를 표시합니다.
|
001
|
|
1/100초
|
SS
|
1/100초를 표시합니다.
|
01
|
|
데시초
|
S
|
1/10초를 표시합니다.
|
1
|
|
시간대 오프셋
|
Z
|
현재 시간대에 대한 UTC(Coordinated Universal Time) 오프셋을 표시합니다.
|
+3:00
|
|
ZZ
|
콜론 구분 기호가 없는 현재 시간대의 UTC 오프셋입니다.
|
+300
|
날짜 및 시간 구분 기호 사용
구두점 문자를 서로 다른 시간 및 날짜 단위 사이의 구분 기호로 사용할 수 있습니다.
• ,(쉼표)
• . (마침표)
• :(콜론)
• -(대시)
• /(슬래시)
공백을 넣어 단위를 구분할 수도 있습니다.
날짜 및 시간 형식 사용의 예
사용 가능한 시간 및 날짜 형식을 조합하여 요구사항에 맞게 날짜를 표시할 수 있습니다. 예를 들어, 날짜 및 시간을 다음과 같이 표시하려면
다음 형식을 사용합니다.
DD-MM-YYYY hh:mm:ss
설명:
• DD는 일(11)을 나타냅니다.
• MM은 월(10)을 나타냅니다.
• YYYY는 연도(2020)를 나타냅니다.
• hh:mm:ss는 시간을 12시간 형식(12:00:00)으로 나타냅니다.
문자열 주위에 대괄호를 추가하여 날짜 형식을 문장 또는 구로 지정할 수도 있습니다. 예를 들어, 다음 그림에서는 날짜 선택기 위젯 내의 날짜를 보여줍니다.
dddd [the] Do [of] MMMM [at] hh:mm:ss a
설명:
• ddd는 요일을 문자열(Sunday)로 나타냅니다.
• Do은 서수 표시기를 포함한 일 숫자(11th)를 나타냅니다.
• MMMM은 월 이름(October)을 나타냅니다.
• hh:mm:ss는 시간(12:00:00)을 나타냅니다.
• a는 소문자 AM/PM(am)을 나타냅니다.
분기 이름을 Q1, Q2, Q3 및 Q4로 축약하려면 다음을 입력합니다.
[Q]Q
여기서 [Q]는 문자열이며 Q는 분기 번호를 나타냅니다.
날짜 및 시간 형식 지정에 대한 로컬리제이션 토큰 생성
로컬리제이션 토큰을 사용하면 사용자의 현재 로캘에 따라 날짜 형식을 자동으로 변환할 수 있습니다. 날짜 형식에 대한 로컬리제이션 토큰을 추가하려면 다음 단계를 수행합니다.
1. Composer에서 기본값 로컬리제이션 테이블을 엽니다.
2. 로컬리제이션 토큰 탭에서 추가를 클릭합니다. 측면 패널이 나타납니다.
3. 이름 상자에 토큰 이름을 입력합니다. 이 이름은 다른 언어에 대한 토큰을 추가할 때 참조로 사용됩니다.
4. 토큰 값 상자에 현재 언어에 사용할 날짜 및 시간 형식을 입력합니다. 기본값 테이블은 영어 형식을 설정합니다.
5. 입력한 로컬리제이션 토큰 이름을 적어 두고 
을 클릭하여 토큰을 추가하고 패널을 닫은 다음 저장을 클릭합니다. 로컬리제이션 토큰이 테이블에 추가됩니다.
을 클릭하여 토큰을 추가하고 패널을 닫은 다음 저장을 클릭합니다. 로컬리제이션 토큰이 테이블에 추가됩니다.6. 변경하려는 각 언어에 대한 날짜 및 시간 형식을 정의하려면 1~5단계를 반복합니다. 기본값 테이블에서 지정한 토큰 이름을 다른 테이블에 대한 토큰을 생성할 때 참조로 사용합니다.
이제 로컬리제이션 토큰이 각 언어에 대한 특정 형식으로 정의됩니다. 로컬리제이션 토큰을 설정하려면 다음을 수행합니다.
1. Mashup Builder에서 날짜 및 시간 형식을 지원하는 위젯을 선택한 다음 속성 패널을 엽니다.
2. 날짜 및 시간 표시 형식 속성 옆에 있는 
을 클릭하여 서버의 사용 가능한 토큰 목록에서 선택합니다.
을 클릭하여 서버의 사용 가능한 토큰 목록에서 선택합니다.3. 상자에 이전 절차에서 생성한 토큰 이름을 입력합니다.
4. 저장을 클릭하여 매쉬업을 저장합니다.
이제 로컬리제이션 토큰이 속성 값을 설정하는 데 사용되며, 날짜 형식은 매쉬업의 현재 로캘에 따라 자동으로 변경됩니다.
위젯 구성 대화 상자를 사용하여 일부 위젯의 날짜 및 시간 형식을 설정할 수 있습니다. 예를 들어, 값 표시 위젯의 형식을 구성하려면 ValueFormat 속성 옆에 있는 렌더러 및 상태를 클릭합니다. 대화 상자의 렌더러 아래에서 DATETIME을 선택합니다. 이 대화 상자를 사용하여 고급 그리드와 같은 다른 위젯의 날짜 및 시간을 구성할 수 있습니다.
로컬리제이션 테이블 및 토큰에 대한 자세한 내용은 로컬리제이션 테이블을 참조하십시오.