날짜 시간 선택기 위젯(테마 적용 가능)

매쉬업 작성기 > 위젯 > 표준 위젯 > 날짜 시간 선택기 위젯(테마 적용 가능)

날짜 시간 선택기를 사용하면 사용자가 매쉬업에서 날짜 및 시간 값을 선택할 수 있습니다. 런타임에 사용자는 월, 년 및 일을 선택하여 날짜를 지정할 수 있습니다. 필요한 경우 시간, 분, 초를 포함하도록 위젯을 구성할 수 있습니다. 이 항목에는 다음 단원이 포함됩니다.

• 위젯 구조

• 범위 선택 모드

• 시간 선택

• 간격 속성

• 날짜 및 시간 형식 지정

위젯 구조

1. Text field

2. 시작 날짜

3. 종료 날짜

4. 월 드롭다운

5. 년 드롭다운

6. 일 레이블

7. 선택한 날짜

범위 선택 모드

범위 선택을 활성화하려면 DateRange 구성을 true로 설정합니다. 범위 선택 모드에서는 사용자가 날짜 또는 시간을 특정 범위로 제한할 수 있습니다. YearRange 속성에 숫자 값을 입력하여 범위 선택을 제한할 수도 있습니다.

시간 선택

기본적으로 날짜-시간 선택기를 사용하여 날짜를 선택할 수 있습니다. 시간 선택을 활성화하려면 위젯 DateOnly 속성을 false로 설정합니다. 이 속성을 비활성화하면 사용자가 시간과 날짜를 모두 선택할 수 있습니다. 초를 추가하려면 DisplaySeconds 속성을 true로 설정합니다.

간격 속성

달력을 열 때 현재 날짜 또는 시간을 기준으로 선택된 기본값을 오프셋하려면 Interval 속성을 사용합니다. IntervalType 속성을 사용하여 선택한 값을 일, 시, 분 또는 초 단위로 앞뒤로 오프셋할 수 있습니다. 예를 들어, 날짜 선택기 위젯에서 선택한 시간을 30분 앞당기려면 IntervalType을 분으로 설정하고 Interval을 30으로 설정합니다.

날짜 및 시간 형식 지정

다음 속성을 사용하여 날짜 및 시간의 형식을 지정할 수 있습니다.

• DateOrder 속성을 사용하면 날짜 순서를 설정할 수 있습니다. 기본적으로 날짜 순서는 런타임에 사용자의 로캘을 기준으로 런타임에 자동으로 설정됩니다.

• FormatToken에서 날짜 및 시간 형식을 사용자 정의할 수 있습니다. FormatToken 속성은 DisplaySeconds, DateOnly, DateDelimiter, MonthFormat 및 DateOrder 속성을 재정의합니다.

◦ DisplaySeconds: DisplaySeconds 속성을 사용하면 사용자는 초를 서로 다른 두 가지 형식으로 표시할 수 있습니다.

a. 0:59

b. 00 59

◦ DateOnly: DateOnly 속성을 통해 사용자는 일을 세 가지 형식으로 표시할 수 있습니다.

a. 1에서 31 사이의 범위로 표시되는 일입니다.

b. 서수 표시기와 함께 1에서 31 사이의 숫자 범위로 표시되는 일입니다. 첫 번째 일은 1st이고 마지막 일은 31st입니다.

c. 일을 01에서 31 사이의 숫자로 표시합니다.

◦ DateDelimiter: DateDelimiter 속성을 사용하면 사용자가 서로 다른 5가지 유형의 구두점 중 하나를 서로 다른 시간 및 날짜 단위 사이의 구분 기호로 사용할 수 있습니다.

◦ MonthFormat: MonthFormat 속성을 사용하면 사용자는 월을 서로 다른 5가지 형식 중 하나로 표시할 수 있습니다.

a. 월 숫자를 1에서 12 사이의 범위로 표시합니다. 1월은 1이고 12월은 12입니다.

b. 월 숫자를 서수 표시기와 함께 1에서 12 사이의 범위로 표시합니다. 1월은 1st이고 12월은 12th입니다.

c. 월 숫자를 01에서 12 사이의 범위로 표시합니다. 1월은 01이고 12월은 12입니다.

d. 월을 축약 문자열로 표시합니다. 여기서 1월(January)은 1월(Jan)입니다.

e. 전체 월 이름을 문자열(January)로 표시합니다.

◦ DateOrder: DateOrder: 속성을 사용하면 사용자는 날짜 순서를 세 가지 고유한 순서 중 하나로 설정할 수 있습니다.

a. 일-월-년. 기본 형식입니다.

b. 월-일-년

c. 년-월-일

자세한 내용은 위젯의 날짜 및 시간 형식 지정을 참조하십시오.

속성

설명

기본 유형

기본값

바인딩 가능 여부 (Y/N)

로컬리제이션 가능 여부

Label

날짜 시간 선택기 위젯의 레이블에 표시되는 텍스트입니다.

STRING

해당 없음

Disabled

이 속성을 사용하면 매쉬업에서 위젯을 비활성화할 수 있습니다. 위젯이 매쉬업에 표시되지만 클릭할 수는 없습니다.

BOOLEAN

FALSE

HintText

필드에 입력해야 하는 내용에 대해 설명하는 자리 표시자 텍스트를 표시합니다.

STRING

날짜 및 시간 선택

DateOnly

날짜만 표시할 수 있습니다.

BOOLEAN

TRUE

DisplaySeconds

시간을 초와 함께 표시할 수 있습니다.

BOOLEAN

FALSE

DateDelimter

일, 월, 년을 구분하는 데 사용되는 문자를 설정합니다. 예: 하이픈(-) 또는 슬래시(/)(05/10/2020)

STRING

해당 없음

MonthFormat

월을 전체 형식, 간략한 형식 또는 숫자 형식으로 표시할 수 있습니다.

STRING

전체

PrimaryActionPosition

기본 작업 버튼의 위치를 왼쪽 또는 오른쪽으로 설정할 수 있습니다.

기본 작업은 버튼 그룹에 있는

• 완료

버튼입니다.

STRING

왼쪽

DateOrder

날짜 표시 형식을 설정할 수 있습니다. 다른 형식은 자동, 일-월-년, 월-일-년 및 년-월-일입니다.

기본값인 자동을 선택하면 위젯에 시스템 날짜가 나타납니다. 또한 DateDelimiter 및 MonthFormat 속성은 위젯에서 비활성화됩니다.

STRING

자동

FormatToken

기본 자동을 선택하면 사용자 로캘이 날짜 형식을 지정하는 데 사용됩니다. 이 속성은 DateDelimiter 및 MonthFormat 속성을 재정의합니다.

이 속성은 Moment.JS 라이브러리 구문을 사용합니다.

STRING

해당 없음

IntervalType

간격을 시간, 분 또는 일로 설정할 수 있습니다.

초는 ThingWorx 9.2 이상에서만 사용할 수 있습니다.

STRING

시간

Interval

간격을 시간, 분 또는 일로 설정할 수 있습니다.

초 간격은 ThingWorx 9.2 이상에서만 사용할 수 있습니다.

NUMBER

MaxRange

사용자가 시작 날짜와 종료 날짜 사이에서 선택할 수 있는 최대 일 수를 설정합니다.

MaxRange는 ThingWorx 9.4 이상에서만 사용할 수 있습니다.

NUMBER

해당 없음

MaxRangeFailureMessage

시작 날짜와 종료 날짜 사이의 선택한 범위가 MaxRange 값을 초과할 때 표시되는 메시지입니다.

MaxRangeFailureMessage는 ThingWorx 9.4 이상에서만 사용할 수 있습니다.

STRING

해당 없음

CustomClass

위젯의 최상위 div에 CSS를 정의할 수 있습니다. 여러 클래스를 공백으로 구분하여 입력할 수 있습니다.

STRING

해당 없음

TabSequence

사용자가 Tab 키를 누를 때 위젯이 강조 표시되는 순서입니다.

NUMBER

해당 없음

WeeklyCalendarStart

주 단위 달력이 일요일 또는 월요일로 시작하도록 설정할 수 있습니다.

STRING

월요일

InitializeWithCurrentDateTime

날짜 시간 속성을 현재 날짜 및 시간으로 설정할 수 있습니다. 이 속성을 선택하지 않으면 사용자가 날짜와 시간을 입력해야 합니다.

BOOLEAN

TRUE

LabelAlignment

레이블을 위젯의 왼쪽, 오른쪽 또는 가운데에 정렬할 수 있습니다.

STRING

왼쪽

DateTime

날짜 시간 선택기의 날짜 및 시간 값에 대한 소스입니다.

DATETIME

해당 없음

Changed

이 위젯에 대한 데이터가 수정될 때 트리거되는 바인딩 가능한 이벤트입니다.

해당 없음

ResetToDefaultValue

이 위젯에 대한 입력을 기본값으로 재설정합니다.

해당 없음

DateRange

날짜 범위를 년, 월, 일 단위로 설정할 수 있습니다.

이 속성을 선택하면 다음 속성이 추가됩니다.

• StartDate

• StartDateLabel

• EndDate

• EndDateLabel

• RangeHintText

• RangedChanged

이 이벤트는 ThingWorx 9.2 이상에서 사용할 수 있습니다.

BOOLEAN

False

Width

위젯의 너비입니다.

NUMBER

해당 없음

Height

위젯의 높이입니다. 높이는 기본적으로 레이블의 최대 너비로 설정됩니다. 위젯에 여러 줄 레이블이 있으면 높이가 늘어납니다. 고정 높이를 설정하려면 속성 패널에 값을 입력하거나 캔버스에서 위젯의 크기를 조정합니다.

NUMBER

해당 없음

CurrentDateButton

현재 날짜를 선택할 수 있는 버튼을 추가합니다.

BOOLEAN

True

YearRange

매쉬업의 년 범위를 선택할 수 있습니다.

NUMBER

도움이 되셨나요?