커스텀 함수 빠른 시작

Google Apps Script를 사용하여 맞춤 함수를 작성한 후 기본 제공 함수처럼 Google Sheets에서 사용할 수 있습니다.

다음 빠른 시작 샘플에서는 할인된 상품의 할인가를 계산하는 맞춤 함수를 만듭니다. 할인가는 미국 달러로 표시됩니다.

목표

  • 스크립트를 설정합니다.
  • 스크립트를 실행합니다.

기본 요건

이 샘플을 사용하려면 다음 기본 요건이 필요합니다.

  • Google 계정 (Google Workspace 계정의 경우 관리자 승인이 필요할 수 있음)
  • 인터넷에 액세스할 수 있는 웹브라우저

스크립트 설정

  1. 새 스프레드시트를 만듭니다.
  2. 새 스프레드시트 내에서 메뉴 항목 확장 프로그램 > Apps Script를 선택합니다.

  3. 스크립트 편집기에서 코드를 삭제하고 아래 코드를 붙여넣습니다. 그런 다음 저장 저장 아이콘을 클릭합니다.

    /**
 * Calculates the sale price of a value at a given discount.
 * The sale price is formatted as US dollars.
 *
 * @param {number} input The value to discount.
 * @param {number} discount The discount to apply, such as .5 or 50%.
 * @return The sale price formatted as USD.
 * @customfunction
 */
function salePrice(input, discount) {
  let price = input - (input * discount);
  let dollarUS = Intl.NumberFormat("en-US", {
    style: "currency",
    currency: "USD",
});
  return dollarUS.format(price);
}

스크립트 실행

  1. 스프레드시트로 다시 전환합니다.
  2. 셀에 =salePrice(100,.2)를 입력합니다. 첫 번째 매개변수는 원래 가격을 나타내고 두 번째 매개변수는 할인율을 나타냅니다. 소수점 쉼표를 사용하는 지역에 거주하는 경우 대신 =salePrice(100;0,2)를 입력해야 할 수 있습니다.

셀에 입력한 수식은 이전 섹션에서 만든 스크립트의 함수를 실행합니다. 이 함수의 결과는 할인 가격 $80.00입니다.

다음 단계

Apps Script로 Sheets를 확장하는 방법을 계속 알아보려면 다음 리소스를 참고하세요.