מדריך למתחילים: פונקציות מותאמות אישית (original) (raw)

מדריך למתחילים: פונקציות מותאמות אישית

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

אתם יכולים להשתמש ב-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.

השלבים הבאים

כדי להמשיך ללמוד איך להרחיב את Sheets באמצעות Apps Script, כדאי לעיין במקורות המידע הבאים:

• פונקציות מותאמות אישית בגיליון אלקטרוני
• תפריטים מותאמים אישית ב-Google Workspace
• הרחבת Google Sheets

אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers‏.‏ Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.

עדכון אחרון: 2025-05-08 (שעון UTC).