.. highlightlang:: us

.. _excel_sheet_open:

excel_sheet_open
================

.. index:: excel_sheet_open

.. us.tag  excel_sheet_open NOTREADYENGLISH excel-read New550

:ref:`excel_sheet_open` opens an Excel sheet.

.. function::  oSheet = excel_sheet_open(oExcel, sheet_name)

.. us.return

**Return Value**

*oSheet* is an object or the value 0 in case of an error.

.. us.params

**Parameters**

.. uparam:: oExcel

   *oExcel* is an object created with :ref:`excel_open`.

.. uparam:: sheet_name

   *sheet_name* is a sheet name or the index of a sheet. The first sheet
   has the index 1.

.. us.comment

**Comment**

If the sheet object is no longer in use
invoked :ref:`excel_sheet_close` to close the sheet.

.. us.example

**Example**

See :ref:`excel_open`.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.5.0
     - New

.. seealso::
   :ref:`overview-excel-files`,
   :ref:`excel_create`,
   :ref:`excel_sheet_create`,
   :ref:`excel_open`

:sub:`id-1405700`