Table To Excel (Conversion)

Summary

Converts a table to a Microsoft Excel file (.xls or .xlsx).

Usage

  • The extension of the output file controls the output Excel format. If the extension is .xls, the file format will be Excel Binary File Format. If the extension is .xlsx, the file format will be Office Open XML.

  • The .xls format has a limitation of 65535 rows and 256 columns.

  • The output Excel file will contain a single sheet. The name of the sheet will be the same as the file name without .xls or .xlsx.

Parameters

LabelExplanationData Type
Input Table

The table to be converted to Microsoft Excel.

Table View
Output Excel File (.xls or .xlsx)

The output Excel file. Specify the format of the Excel file using an .xls or .xlsx file extension.

File
Use field alias as column header
(Optional)

Specifies how column names in the output are determined.

  • Unchecked—Column headers will be set using the input's field names. This is the default.
  • Checked—Column headers will be set using the input geodatabase table's field aliases. If the input is a layer in a map, the value set on the layer's field alias is ignored.
Boolean
Use domain and subtype description
(Optional)

Controls how values from subtype fields or fields with a coded value domain are transferred to the output.

  • Unchecked—All field values will be used as they are stored in the table. This is the default.
  • Checked—For subtype fields, the subtype description will be used. For fields with a coded value domain, the coded value descriptions will be used.
Boolean

arcpy.conversion.TableToExcel(Input_Table, Output_Excel_File, {Use_field_alias_as_column_header}, {Use_domain_and_subtype_description})
NameExplanationData Type
Input_Table

The table to be converted to Microsoft Excel.

Table View
Output_Excel_File

The output Excel file. Specify the format of the Excel file using an .xls or .xlsx file extension.

File
Use_field_alias_as_column_header
(Optional)

Specifies how column names in the output are determined.

  • NAMEColumn headers will be set using the input's field names. This is the default.
  • ALIASColumn headers will be set using the input geodatabase table's field aliases. If the input is a layer in a map, the value set on the layer's field alias is ignored.
Boolean
Use_domain_and_subtype_description
(Optional)

Controls how values from subtype fields or fields with a coded value domain are transferred to the output.

  • CODEAll field values will be used as they are stored in the table. This is the default.
  • DESCRIPTIONFor subtype fields, the subtype description will be used. For fields with a coded value domain, the coded value descriptions will be used.
Boolean

Code sample

TableToExcel example (Python window)

The following Python window script demonstrates how to use the TableToExcel function in immediate mode.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.TableToExcel_conversion("gdb.gdb/addresses", "addresses.xls")
TableToExcel example 2 (stand-alone script)

Converts a table to a Microsoft Excel workbook.

# Name: TableToExcel_2.py

import arcpy

# Set environment settings
arcpy.env.workspace = "c:/data"

# Set local variables
in_table = "gdb.gdb/addresses"
out_xls = "addresses.xls"

# Execute TableToExcel
arcpy.TableToExcel_conversion(in_table, out_xls)

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics