커스텀 함수 빠른 시작

Google Apps Script를 사용하여 커스텀 함수를 작성한 다음 내장 함수처럼 Google 스프레드시트에서 사용할 수 있습니다.

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

목표

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

기본 요건

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

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