valueFormatting은 UI에서 값을 표시하는 실험적 구성입니다. 숫자, 날짜와 시각, boolean 및 Foundry 식별자의 표시를 지정합니다. 아래 표시 예시는 영문 숫자 표기를 사용하며 실제 표시는 로캘과 선택한 형식에 따릅니다.
자릿수 묶음, 음수 괄호 표기, 정수 및 소수 또는 유효 자릿수의 최소와 최대를 지정합니다. useGrouping=true의 예로 1234567은 1,234,567이 되고, 소수 최대 두 자리의 3.14159는 3.14로 표시합니다.
표기법 예시
STANDARD1234를 1,234로 표시 SCIENTIFIC1234를 1.234E3로 표시 ENGINEERING1234를 1.234E3로 표시 COMPACT1234를 1.2K로 표시
CEIL의 예시는 3.1을 4로, FLOOR는 3.9를 3으로 표시합니다. ROUND_CLOSEST는 3.4를 3, 3.6을 4로 표시합니다.
정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
useGroupingboolean선택 true이면 로캘에 맞는 자릿수 묶음을 표시합니다. 영어 표기에서는 천 단위 구분 등이 해당합니다. convertNegativeToParenthesisboolean선택 true이면 음수 부호 대신 괄호로 값을 감쌉니다. minimumIntegerDigitsinteger선택 minimumFractionDigitsinteger선택 maximumFractionDigitsinteger선택 minimumSignificantDigitsinteger선택 maximumSignificantDigitsinteger선택 notationenum선택 일반, 과학적, 공학적 또는 축약 숫자 표기입니다. 허용값: STANDARD, SCIENTIFIC, ENGINEERING, COMPACT. roundingModeenum선택 숫자 올림, 내림 또는 가장 가까운 값으로의 반올림 방식입니다. 허용값: CEIL, FLOOR, ROUND_CLOSEST.
구성 입력과 표시
기간의 humanReadable 3661초를 1h 1m 1s로 표시 기간의 timecode 3661초를 01:01:01로 표시 고정값 매핑 {"1":"First","2":"Second","3":"Third"}이면 2를 Second로 표시접두사와 접미사 1234.56에 USD 와 total을 붙여 USD 1,234.56 total로 표시 THOUSANDS1500을 1.5K로 표시 MILLIONS2500000을 2.5M으로 표시 BILLIONS3200000000을 3.2B로 표시 통화 USD의 1234.56을 전체 표기 USD 1,234.56 또는 축약 표기 USD 1.2K로 표시 표준 단위 25와 celsius 단위로 25 degrees C 같은 단위 표기 사용자 단위 1500과 widgets 단위로 1,500 widgets 표시 PERCENTAGE0.15를 15%로 표시 PER_MILLE0.015를 15‰로 표시 BASIS_POINTS0.0015를 15bps로 표시
고정값 맵의 키는 정수 의미를 가지며 JSON 객체에서는 문자열 키로 인코딩합니다. 날짜의 stringFormat은 패턴 문자열을, localizedFormat은 지정한 지역화 형식을 사용합니다. timestamp는 사용자의 현지 시간대 또는 고정 시간대 설정도 가집니다.
숫자 접두사와 접미사, 통화 및 단위와 고정 시간대의 값은 상수 문자열 또는 다른 속성의 API 이름으로 지정할 수 있습니다. knownType의 JSON 값은 USER_OR_GROUP_ID, RESOURCE_RID, ARTIFACT_GID입니다.
UI에서 속성값을 표시하는 형식입니다. 실험적 기능이므로 향후 바뀔 수 있습니다. 숫자의 단위, 비율과 축약, 날짜와 시각의 패턴, boolean 표시 문자열 및 Foundry 식별자 형식을 지정합니다.
날짜 속성값의 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: date. dateformatunion<stringFormat, localizedFormat>필수
명시적인 날짜 표시 패턴입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: stringFormat. stringFormatpatternstring필수 날짜와 시각 패턴으로 구성한 유효한 형식 문자열입니다.
미리 정의된 지역화 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: localizedFormat. localizedFormatformatenum필수 지역화된 날짜 및 시각 표시 종류입니다. 허용값: DATE_FORMAT_RELATIVE_TO_NOW, DATE_FORMAT_DATE, DATE_FORMAT_YEAR_AND_MONTH, DATE_FORMAT_DATE_TIME, DATE_FORMAT_DATE_TIME_SHORT, DATE_FORMAT_TIME, DATE_FORMAT_ISO_INSTANT.
숫자 표시 설정을 담는 분기입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: number. numbernumberTypeunion<standard, duration, fixedValues, affix, scale, currency, standardUnit, customUnit, ratio>필수
단위나 배율 변환 없이 숫자의 기본 표시를 설정합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: standard. standardbaseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다.
공통 숫자 기본 옵션 을 사용합니다.
숫자로 된 기간을 표시합니다. 3661초의 예시는 읽기 쉬운 형식의 1h 1m 1s 또는 타임코드 01:01:01입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: duration. durationformatStyleunion<humanReadable, timecode>필수 precisionenum선택 기간을 표시할 최대 정밀도입니다. 허용값: DAYS, HOURS, MINUTES, SECONDS, AUTO. baseValueenum필수 입력 기간 값의 단위입니다. 허용값: SECONDS, MILLISECONDS.
기간을 읽기 쉬운 문자열로 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: humanReadable. humanReadableshowFullUnitsboolean선택 시간 단위를 전체 이름으로 표시할지 약어로 표시할지 정합니다.
기간을 타임코드로 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: timecode. timecode
정수를 사용자 표시 문자열로 연결합니다. 1, 2, 3을 First, Second, Third에 연결하면 값 2는 Second로 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: fixedValues. fixedValuesvaluesmap<FixedValuesMapKey, string>선택
맵의 키는 FixedValuesMapKey(integer), 값은 string(string)입니다.
키: 고정값 매핑의 정수 키입니다.
표시한 숫자의 앞뒤에 문자열을 붙입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: affix. affixbaseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다. affixobject필수
공통 숫자 기본 옵션 을 사용합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
prefixunion<constant, propertyType>선택 postfixunion<constant, propertyType>선택
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
지정한 배율로 나눈 값에 접미사를 붙여 큰 수를 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: scale. scalescaleTypeenum필수 천, 백만 또는 십억으로 나누고 각각 K, M, B 접미사를 붙입니다. 허용값: THOUSANDS, MILLIONS, BILLIONS. baseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다.
공통 숫자 기본 옵션 을 사용합니다.
숫자를 통화 기호와 표기 방식에 맞게 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: currency. currencybaseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다. styleenum필수 통화의 전체 표기 또는 축약 표기를 선택합니다. 허용값: STANDARD, COMPACT. currencyCodeunion<constant, propertyType>필수
공통 숫자 기본 옵션 을 사용합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
Intl.NumberFormat에서 지원하는 표준 단위를 사용합니다. 예시 단위는 meter, kilogram, celsius, percent입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: standardUnit. standardUnitbaseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다. unitunion<constant, propertyType>필수
공통 숫자 기본 옵션 을 사용합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
표준 형식에 없는 사용자 단위를 사용합니다. requests/sec 또는 widgets 같은 단위를 지정할 수 있습니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: customUnit. customUnitbaseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다. unitunion<constant, propertyType>필수
공통 숫자 기본 옵션 을 사용합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
값을 백분율, 천분율 또는 basis points로 확대하여 접미사와 함께 표시합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: ratio. ratioratioTypeenum필수 PERCENTAGE는 100배와 %, PER_MILLE는 1000배와 ‰, BASIS_POINTS는 10000배와 bps를 사용합니다. 허용값: PERCENTAGE, PER_MILLE, BASIS_POINTS. baseFormatOptionsobject필수 정밀도, 자릿수 묶음, 반올림과 표기법을 제어하는 숫자 기본 옵션입니다. JavaScript Intl.NumberFormat과 대응하는 설정이며 예를 들어 그룹화, 소수 자릿수 제한과 과학적 표기를 지정합니다.
공통 숫자 기본 옵션 을 사용합니다.
boolean 속성값의 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: boolean. booleanvalueIfTruestring필수 값이 true일 때 표시할 문자열입니다. valueIfFalsestring필수 값이 false일 때 표시할 문자열입니다.
알려진 Foundry 식별자의 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: knownType. knownTypeknownTypeenum필수 사용자 또는 그룹 ID, 리소스 RID와 산출물 GID를 위한 표시 형식입니다. 허용값: USER_OR_GROUP_ID, RESOURCE_RID, ARTIFACT_GID.
timestamp 속성값의 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: timestamp. timestampformatunion<stringFormat, localizedFormat>필수 displayTimezoneunion<static, user>필수
명시적인 날짜 표시 패턴입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: stringFormat. stringFormatpatternstring필수 날짜와 시각 패턴으로 구성한 유효한 형식 문자열입니다.
미리 정의된 지역화 표시 형식입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: localizedFormat. localizedFormatformatenum필수 지역화된 날짜 및 시각 표시 종류입니다. 허용값: DATE_FORMAT_RELATIVE_TO_NOW, DATE_FORMAT_DATE, DATE_FORMAT_YEAR_AND_MONTH, DATE_FORMAT_DATE_TIME, DATE_FORMAT_DATE_TIME_SHORT, DATE_FORMAT_TIME, DATE_FORMAT_ISO_INSTANT.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: static. staticzoneIdunion<constant, propertyType>필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: constant. constantvaluestring필수
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: propertyType. propertyTypepropertyApiNamestring필수 속성 유형의 API 이름입니다.
사용자의 현지 시간대를 사용합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: user. user