google-apps-script
Google पत्रक के लिए एक कस्टम फ़ंक्शन बनाएं
खोज…
परिचय
Google डॉक्स में एक कस्टम फ़ंक्शन एक विशिष्ट दस्तावेज़ से जुड़ा हुआ है (और इस प्रकार केवल उस दस्तावेज़ में उपयोग किया जा सकता है)।
इसलिए इसे उस दस्तावेज़ के अंकों के संपादन (उपकरण -> स्क्रिप्ट संपादक) के साथ बनाया जाना चाहिए। एक बार सहेजने के बाद, इसे किसी भी अन्य नियमित स्प्रेडशीट सूत्र की तरह उपयोग किया जा सकता है।
मानक गुरुत्वाकर्षण कस्टम स्थिरांक
यह फ़ंक्शन निर्दिष्ट त्वरण इकाइयों (1 सेमी / एस 2 के लिए 2, फीट / एस² के लिए 2, मी / एस for के लिए 3) में फ्राँसेट ग्रेविटी निरंतरता लौटाता है।
/**
* Returns the standard gravity constant in the specified acceleration units
* Values taken from https://en.wikipedia.org/wiki/Standard_gravity on July 24, 2016.
*
* @param {number} input 1 for cm/s², 2 for ft/s², 3 for m/s²
*
* @customfunction
*/
function sg(units_key) {
var value;
switch(units_key) {
case 1:
value = 980.665;
break;
case 2:
value = 32.1740;
break;
case 3:
value = 9.80665;
break;
default:
throw new Error('Must to specify 1, 2 or 3');
}
return value;
}
फ़ंक्शन का उपयोग करने के लिए, इसे स्क्रिप्ट एडिटर (टूल -> स्क्रिप्ट एडिटर ...) का उपयोग करके एक स्प्रेडशीट के लिए बाध्य होना चाहिए। एक बार फ़ंक्शन जोड़ने के बाद, इसे किसी सेल के सूत्र में फ़ंक्शन को कॉल करके किसी भी अन्य Google शीट फ़ंक्शन की तरह उपयोग किया जा सकता है।
ध्यान दें कि जब सूत्र में टाइप किया जाता है तो फ़ंक्शन स्वतः पूर्ण में कैसे दिखता है। यह फ़ंक्शन घोषणा के ऊपर मल्टी-लाइन टिप्पणी के कारण है जो यह बताने के लिए उपयोग किया जाता है कि फ़ंक्शन JSDoc और Javadoc के समान क्या है। स्वत: पूर्ण में सूत्र दिखाने के लिए, @customfunction टैग को टिप्पणी में निर्दिष्ट किया जाना चाहिए।
मूल उदाहरण
स्प्रेडशीट में भद्दे #DIV/0 त्रुटियों से बचने के लिए, एक कस्टम फ़ंक्शन का उपयोग किया जा सकता है।
/**
* Divides n by d unless d is zero, in which case, it returns
* the given symbol.
*
* @param {n} number The numerator
* @param {d} number The divisor
* @param {symbol} string The symbol to display if `d == 0`
* @return {number or string} The result of division or the given symbol
*
* @customfunction
*/
function zeroSafeDivide(n, d, symbol) {
if (d == 0)
return symbol;
else
return n / d;
}
फ़ंक्शन का उपयोग करने के लिए, इसे स्क्रिप्ट एडिटर ( टूल -> स्क्रिप्ट एडिटर ... ) का उपयोग करके एक स्प्रेडशीट के लिए बाध्य होना चाहिए। एक बार फ़ंक्शन जोड़ने के बाद, इसे किसी सेल के सूत्र में फ़ंक्शन को कॉल करके किसी भी अन्य Google शीट फ़ंक्शन की तरह उपयोग किया जा सकता है।
ध्यान दें कि जब सूत्र में टाइप किया जाता है तो फ़ंक्शन स्वतः पूर्ण में कैसे दिखता है। यह फ़ंक्शन घोषणा के ऊपर मल्टी-लाइन टिप्पणी के कारण है जो यह बताने के लिए उपयोग किया जाता है कि फ़ंक्शन JSDoc और Javadoc के समान क्या है। स्वत: पूर्ण में सूत्र दिखाने के लिए, @customfunction टैग को टिप्पणी में निर्दिष्ट किया जाना चाहिए।