.. highlightlang:: us

.. index:: excel_sheet_create

.. _excel_sheet_create:

excel_sheet_create
==================

.. us.tag  excel_sheet_create NOTREADYENGLISH excel excel-write New550

:ref:`excel_sheet_create` creates a new Excel sheet.

.. function::  oSheet = excel_sheet_create(oExcel, ssSheetname, nRows, nColumns)

.. us.return

**Return Value**

*oSheet* is an object handle.

.. us.params

**Parameters**

.. uparam:: oExcel

   *oExcel* is an object created by :ref:`excel_create`.

.. uparam:: ssSheetname

   *ssSheetname* is the sheet name. The name length is limited to 31 characters.
   The following characters are invalid: ``/ \ * ? [ ]``. The name will be 
   clipped after 31 characters and invalid characters will be replaced by an 
   underscore.

.. uparam:: nRows

   *nRows* is the number of rows.

.. uparam:: nColumns

   *nColumns* is the number of columns.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.5.0
     - New
   * - 5.15.4
     - Sheet name is checked for invalid characters

.. seealso::
   :ref:`overview-excel-files`,
   :ref:`excel_sheet_create`,
   :ref:`excel_sheet_put_rows`

:sub:`id-1329126`