This article has been archived. It is offered "as is" and will no longer be updated.
For a Microsoft Excel 2002 version of this article, see 291309. For a Microsoft Excel 98 and earlier version of this article, see 161120.
You can call most built-in Microsoft Excel worksheet functions directly from a Microsoft Visual Basic for Applications macro. This article describes how to use a built-in worksheet function in a macro.
Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact a Microsoft Certified Partner or Microsoft Advisory Services. For more information, visit these Microsoft Web sites:
You can use most built-in worksheet functions in a macro by calling the function as a method of the Application object or the WorksheetFunction object. For example, to successfully call the ACOS worksheet function, you can use the following line of code in a macro:
X = WorksheetFunction.Acos(-1)
NOTE: If you attempt to use a built-in worksheet function withoutqualifying the function with the Application or WorksheetFunction object, you may receive the following error message:
Sub or Function Not Defined
Visual Basic for Applications provides many functions that are equivalent to the built-in worksheet functions in Microsoft Excel. However, not all of the built-in worksheet functions will work with the Application or WorksheetFunction objects. You cannot use a built-in worksheet function in a macro by calling the function as a method of the Application object or the WorksheetFunction object if there is an equivalent function in Visual Basic.
For additional information about the worksheet functions that are notsupported with the Application or WorksheetFunction objects, click the article number below to view the article in the Microsoft Knowledge Base:
213660 XL2000: Not All Worksheet Functions Supported As Methods of Application Object
For more information about a complete list of the worksheet functions that you can call with the Application object, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type list of worksheet functions available to visual basic in the Office Assistant or the Answer Wizard, and then click Search to view the topic.
For more information about using Microsoft Excel Worksheet functions in Visual Basic, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type worksheet functions in the Office Assistant or the Answer Wizard, and then click Search to view the topic.