Spreadsheets

Microsoft^® Excel^® spreadsheets

Read and write data in spreadsheet files, including .xls and .xlsx files into tables, timetables, matrices, or arrays in MATLAB^®. You can import a selected range of data or you can import multiple worksheets from spreadsheet files.

Apps

Import Tool

Import data from file

Live Editor Tasks

Import Data

Import data from a file in the Live Editor (Since R2023a)

Functions

expand all

Read and Write Tables or Timetables

Basic Import and Export

`readtable`	Create table from file
`writetable`	Write table to file
`readtimetable`	Create timetable from file
`writetimetable`	Write timetable to file
`sheetnames`	Get sheet names from spreadsheet file

Define Import Rules

`detectImportOptions`	Create import options based on file content
`spreadsheetImportOptions`	Import options object for Spreadsheets
`getvaropts`	Get variable import options
`setvaropts`	Set variable import options
`setvartype`	Set variable data types
`preview`	Preview eight rows from file using import options

Read and Write Matrices and Arrays

`readmatrix`	Read matrix from file
`writematrix`	Write a matrix to a file
`readcell`	Create cell array from file
`writecell`	Write cell array to file
`readvars`	Read variables from file
`importdata`	Load data from file

Objects

spreadsheetDatastore Datastore for spreadsheet files

Topics

Read Spreadsheet Data

Import Spreadsheets
Spreadsheets, such as Microsoft Excel files, often contain a mix of numeric and text data as well as variable and row names.
Read Spreadsheet Data Using Import Tool
Preview spreadsheet data from a file or the clipboard and select data to import using the Import tool.
Read Spreadsheet Data into Table
The best way to represent tabular spreadsheet data in MATLAB is in a table since tables can store heterogeneous (a mix of numeric and text) data, as well as variable and row names.
Control How MATLAB Imports Your Data
If you want to control the import process beyond the options provided by the readtable function, such as defining how to handle missing data or errors, then create an import options object before importing the data.
Read Spreadsheet Data into Array or Individual Variables
In addition to importing data as a table using readtable, you can also import data as a matrix, a cell array, or import separate variables directly in to the workspace.
Read Collection or Sequence of Spreadsheet Files
Read and manage data from a collection of spreadsheet files.

Write Spreadsheet Data

Write Data to Excel Spreadsheets
Export data in the workspace to a Microsoft Excel spreadsheet file.

Related Information

Importing Spreadsheets (4 min, 34 sec)