스크립트의 기본 통화 값
스크립트에서 통화 필드를 사용할 수 있습니다.
이러한 메서드는 GlideElement 개체에서 사용할 수 있습니다.
통화 값을 표시하려면 getDisplayValue() 표시 API를 사용합니다. 표시 이외의 방법으로 통화 값을 사용하려면 형식이 지정되지 않은 숫자를 반환/수락하는 API를 사용합니다.
주:
값에 대한 계산을 수행하기 전에 getDisplayValue() 메서드를 사용한 다음 문자열을 처리하여 서식 정보를 제거하지 마십시오.
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);
통화 또는 가격 필드에서 GlideAggregate를 사용할 때 기준 통화 값으로 작업하고 있습니다. 집계 값을 사용자의 세션 통화로 변환하여 표시해야 합니다. 결과 값이 예상과 다를 수 있습니다. 통화 또는 가격 필드 값, 그리고 집계에 사용되는 참조 통화에 사용되는 환산율이 변경되었을 수 있습니다.
통화 값이 포함된 기록을 삭제하면 플랫폼에서 연결된 통화 기록을 모두 삭제합니다.
주:
통화 필드가 있는 테이블에는 deleteMultiple() 을 사용하지 마십시오. 항상 각 기록을 개별적으로 삭제하십시오.
통화 값은 소수점 이하 4자리를 포함합니다.
- getValue()와 같은 값을 반환하는 API는 소수점 이하 4자리까지 반환합니다. 후행 0은 항상 제거됩니다.
- getDisplayValue()와 같이 표시 값을 반환하는 API에는 소수점 이하 2자리 이상에서 소수점 이하 4자리까지 있습니다.
- GlideAggregate는 소수점 이하 4자리를 반환합니다.
시스템에서 소수점 이하 두 자리를 사용하도록 할 수 있습니다. 소수점 두 자리로 설정하면 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의 통화 값을 사용합니다.
| 메서드 이름 | 설명 | 예제 |
|---|---|---|
| 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() | 통화 값을 다음과 같이 설정합니다.
|
4369.21 또는 4369.21엔 |
| setDisplayValue() | 통화 값을 다음과 같이 설정합니다.
|
4369.21 또는 4369.21엔 |