عملکرد سفارشی شروع سریع (original) (raw)

عملکرد سفارشی شروع سریع

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

می‌توانید از Google Apps Script برای نوشتن یک عملکرد سفارشی استفاده کنید، سپس از آن در Google Sheets درست مانند یک عملکرد داخلی استفاده کنید.

نمونه شروع سریع زیر یک تابع سفارشی ایجاد می کند که قیمت فروش اقلام تخفیف خورده را محاسبه می کند. قیمت فروش به صورت دلار آمریکا درج شده است.

اهداف

• اسکریپت را تنظیم کنید
• اسکریپت را اجرا کنید.

پیش نیازها

برای استفاده از این نمونه به پیش نیازهای زیر نیاز دارید:

• یک حساب Google (حساب‌های Google Workspace ممکن است به تأیید سرپرست نیاز داشته باشند).
• یک مرورگر وب با دسترسی به اینترنت.

اسکریپت را تنظیم کنید

1. یک صفحه گسترده جدید ایجاد کنید.
2. از داخل صفحه‌گسترده جدید، مورد منو Extensions > 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 می شود.

مراحل بعدی

برای ادامه یادگیری نحوه گسترش Sheets با Apps Script، به منابع زیر نگاهی بیندازید:

• توابع سفارشی صفحه گسترده
• منوهای سفارشی در Google Workspace
• Google Sheets را گسترش دهید

جز در مواردی که غیر از این ذکر شده باشد،‌محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers‏ مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.

تاریخ آخرین به‌روزرسانی 2025-05-08 به‌وقت ساعت هماهنگ جهانی.