CustomFunctions.ErrorCode enum
カスタム関数のエラー コード。 関数を呼び出したセルにエラー コードが表示されます。
これらのエラー コードに加えて、カスタム エラー メッセージが表示されます。 カスタム メッセージはエラー インジケーター メニューに表示されます。このメニューには、エラーが表示されている各セルのエラー フラグにカーソルを合わせることでアクセスします。
注釈
例
/**
* Returns the #NUM! error as part of a 2-dimensional array.
* @customfunction
* @param {number} first First parameter.
* @param {number} second Second parameter.
* @param {number} third Third parameter.
* @returns {number[][]} Three results, as a 2-dimensional array.
*/
function returnInvalidNumberError(first, second, third) {
// Use the `CustomFunctions.Error` object to retrieve an invalid number error.
const error = new CustomFunctions.Error(
CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
);
// Enter logic that processes the first, second, and third input parameters.
// Imagine that the second calculation results in an invalid number error.
const firstResult = first;
const secondResult = error;
const thirdResult = third;
// Return the results of the first and third parameter calculations
// and a #NUM! error in place of the second result.
return [[firstResult], [secondResult], [thirdResult]];
};
フィールド
| divisionByZero = "#DIV/0!" | このエラー コードは、使用されている関数がゼロまたは空のセルで除算されていることを示します。 カスタム エラー メッセージは使用できません。 |
| invalidName = "#NAME?" | このエラー コードは、関数名に入力ミスがあることを示します。 このエラー コードはカスタム関数の入力エラーとしてサポートされますが、カスタム関数の出力エラーとしてはサポートされないことに注意してください。 カスタム エラー メッセージは使用できません。 |
| invalidNumber = "#NUM!" | このエラー コードは、関数の数値に問題があることを示します。 カスタム エラー メッセージは使用できません。 |
| invalidReference = "#REF!" | このエラー コードは、関数が無効なセルを参照していることを示します。 このエラー コードはカスタム関数の入力エラーとしてサポートされますが、カスタム関数の出力エラーとしてはサポートされないことに注意してください。 カスタム エラー メッセージは使用できません。 |
| invalidValue = "#VALUE!" | このエラー コードは、関数の値のデータ型が間違っていることを示します。 必要に応じて、エラー コードに加えてカスタム エラー メッセージを使用できます。 |
| notAvailable = "#N/A" | このエラー コードは、関数またはサービスが使用できないことを示します。 必要に応じて、エラー コードに加えてカスタム エラー メッセージを使用できます。 |
| nullReference = "#NULL!" | このエラー コードは、関数の範囲が交差していないことを示します。 カスタム エラー メッセージは使用できません。 |