getValue() 및 getCurrencyValue()와 같은 메서드는 서식이 지정되지 않은 숫자를 문자열로 반환합니다. 부동 소수점 값을 얻으려면 JavaScript 함수 parseFloat()를 사용한 다음 결과 값을 사용하여 계산을 수행합니다. 이러한 값과 연결된 통화를 가져오려면 통화 코드를 반환하는 API를 사용합니다. getCurrencyCode() 메서드를 사용하여 필드의 통화를 확인할 수도 있습니다.

var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();

setValue() 메서드를 사용하여 통화 필드의 값을 설정합니다. 이 통화가 사용자의 세션 통화인 경우 일반 숫자 또는 이를 포함하는 문자열의 부동 소수점 숫자를 사용합니다. 그렇지 않으면 값 앞에 3자리 ISO 통화 코드를 붙입니다.

var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);

통화 값이 포함된 기록을 삭제하면 플랫폼에서 연결된 통화 기록을 삭제합니다.

통화 값에는 소수점 이하 네 자리가 포함됩니다.

• getValue()와 같은 값을 반환하는 API는 소수점 이하 네 자리까지 반환합니다. 후행 0은 항상 제거됩니다.
• getDisplayValue()와 같은 표시 값을 반환하는 API는 소수점 이하 2자리와 최대 4자리입니다.
• GlideAggregate는 소수점 이하 네 자리를 반환합니다.

시스템에서 소수점 이하 두 자리를 사용하도록 할 수 있습니다. 소수점 이하 두 자리로 설정하면 API에서 반환된 숫자 값에 소수점 이하 두 자리가 포함됩니다. 통화 환산율은 소수점 이하 자릿수가 더 많을 수 있지만 통화 필드는 소수점 이하 두 자리만 저장합니다. 숫자 값을 허용하는 API는 소수 자릿수를 두 자리로 반올림합니다.

• getValue()와 같은 값을 반환하는 API는 소수점 이하 두 자리까지 반환합니다. 데이터베이스에서 읽은 값의 경우 후행 0이 제거되지만 나중에 00과 같은 값을 설정하면 1.00이 반환될 수 있습니다. 반환되는 후행 0의 수는 일정하지 않습니다.
• 표시 값(예: getDisplayValue())을 반환하는 API는 소수점 이하 두 자리까지 포함합니다. 경우에 따라 7.10과 같은 값에 대해서도 두 자리를 반환할 수 있지만 다른 경우에는 후행 0을 제거할 수 있습니다. 반환되는 후행 0의 수는 일정하지 않습니다.
• GlideAggregate는 소수점 이하 두 자리를 반환합니다.

다음 예제에서는 사용자의 로캘을 독일어(de.DE)로 설정하고 참조 통화를 USD로 설정합니다. 값은 일본 엔화로 21345.67, 유로로 1563.72, 미국 달러로 1152.48의 통화 가치를 사용합니다.

표 1. 통화 필드에 액세스하는 방법

메서드 이름	설명	예
getValue()를 호출합니다.	사용자의 세션 통화로 통화 값을 형식이 지정되지 않은 숫자로 반환합니다.	1563.72
getReferenceValue()를 호출합니다.	통화 값을 참조 통화로 형식이 지정되지 않은 숫자로 반환합니다.	1152.48
getSessionValue()를 호출합니다.	사용자의 세션 통화로 통화 값을 형식이 지정되지 않은 숫자로 반환합니다.	1563.72
getCurrencyValue()를 호출합니다.	형식이 지정되지 않은 숫자로 입력된 통화 값을 반환합니다.	21345.67
getDisplayValue()를 호출합니다.	통화 기호가 있는 사용자의 로캘 형식이 지정된 사용자의 세션 통화로 통화 값을 반환합니다.	€1.563,72
getSessionDisplayValue()를 호출합니다.	통화 기호가 있는 사용자의 로캘 형식이 지정된 사용자의 세션 통화로 통화 값을 반환합니다.	€1.563,72
getReferenceDisplayValue()를 호출합니다.	통화 기호가 있는 사용자의 로캘 형식이 지정된 참조 통화로 통화 값을 반환합니다.	$1,152.48
getCurrencyDisplayValue()를 호출합니다.	통화 기호를 사용하여 사용자의 로캘에 형식이 지정된 대로 입력한 통화 값을 반환합니다.	21.345,67엔
getCurrencyString()을 호출합니다.	서식이 지정되지 않은 숫자로 입력된 통화 값을 반환하고, 세미콜론으로 구분된 3자리 ISO 통화 코드를 앞에 붙입니다.	21345.67 엔
getCurrencyCode()를 호출합니다.	입력한 통화 값에 대한 3자리 ISO 통화 코드를 반환합니다.	JPY
getSessionCurrencyCode()를 호출합니다.	사용자의 세션 통화에 대한 3자리 ISO 통화 코드를 반환합니다.	EUR
getReferenceCurrencyCode()를 호출합니다.	참조 통화에 대한 3자리 ISO 통화 코드를 반환합니다.	USD
setValue()를 호출합니다.	통화 값을 다음과 같이 설정합니다. 사용자의 세션 통화의 값으로 사용되는 서식이 지정되지 않은 숫자입니다. 서식이 지정되지 않은 숫자이며 세미콜론으로 구분된 3자리 통화 코드를 앞에 붙입니다.	4369.21 또는 JPY 4369.21
setDisplayValue()를 호출합니다.	통화 값을 다음과 같이 설정합니다. 사용자의 세션 통화로 값으로 간주되는 사용자의 로캘로 형식이 지정된 숫자입니다. 사용자의 로캘에 서식이 지정된 숫자로, 세미콜론으로 구분된 3자리 통화 코드 앞에 접두사가 붙습니다.	4369.21 또는 JPY 4369.21