커스텀 함수 빠른 시작

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를 확장하는 방법을 계속 알아보려면 다음 리소스를 살펴보세요.