readmatrix

Leer una matriz de un archivo

Sintaxis

A = readmatrix(filename)

A = readmatrix(filename,opts)

A = readmatrix(___,Name,Value)

Descripción

A = readmatrix(filename) crea un arreglo leyendo datos orientados por columnas de un archivo. La función readmatrix realiza una detección automática de los parámetros de importación para el archivo.

readmatrix determina el formato de archivo de la extensión del archivo:

• .txt, .dat, o .csv para los archivos de texto delimitados

• .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, o .ods para los archivos de hoja de cálculo

Para los archivos que contienen datos mixtos numéricos y de texto, readmatrix importa los datos como un arreglo numérico de forma predeterminada.

A = readmatrix(filename,opts) utiliza adicionalmente las opciones de importación opts.

A = readmatrix(___,Name,Value) crea un arreglo de un archivo con opciones adicionales especificadas por uno o más argumentos de par nombre-valor. Utilice cualquiera de los argumentos de entrada de las sintaxis anteriores antes de especificar los pares nombre-valor.

Para configurar opciones de importación específicas para sus datos, puede utilizar el objeto opts, o puede también especificar pares nombre-valor. Cuando especifique pares nombre-valor además de opts, readmatrix solo es compatible con estos pares nombre-valor:

• Archivos de texto: DateLocale, Encoding

• Archivos de hoja de cálculo: Sheet, UseExcel

Ejemplos

Leer una matriz de un archivo de texto

Muestre el contenido de basic_matrix.txt y, después, importe los datos a una matriz.

type basic_matrix.txt

6,8,3,1
5,4,7,3
1,6,7,10
4,2,8,2
2,7,5,9

M = readmatrix('basic_matrix.txt')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

Leer una matriz de un archivo de hoja de cálculo

Importe los datos numéricos de basic_matrix.xls a una matriz.

M = readmatrix('basic_matrix.xls')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

Leer una matriz de una hoja y rango especificados utilizando las opciones de importación

Previsualice los datos de un archivo de hoja de cálculo e importe datos numéricos como matriz de una hoja y rango específicos.

El archivo de hoja de cálculo airlinesmall_subset.xlsx contiene datos en varias hojas de cálculo de años entre 1996 y 2008. Cada hoja de cálculo tiene datos para un año dado. Previsualice los datos del archivo airlinesmall_subset.xlsx. La función preview muestra datos de la primera hoja de cálculo de forma predeterminada. Las primeras ocho variables en el archivo contienen datos numéricos.

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    

Configure los valores en el objeto opts para importar 10 filas para las primeras cinco variables de la hoja de cálculo denominada '2007'.

opts.Sheet = '2007';
opts.SelectedVariableNames = [1:5]; 
opts.DataRange = '2:11';
M = readmatrix('airlinesmall_subset.xlsx',opts)

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

Leer una matriz de una hoja y rango especificados

Previsualice los datos de un archivo de hoja de cálculo e importe datos numéricos, como una matriz, de una hoja y rango específicos.

El archivo de hoja de cálculo airlinesmall_subset.xlsx contiene datos en varias hojas de cálculo de años entre 1996 y 2008. Cada hoja de cálculo tiene datos para un año dado. Previsualice los datos del archivo airlinesmall_subset.xlsx. La función preview muestra datos de la primera hoja de cálculo de forma predeterminada. Las primeras ocho variables en el archivo contienen datos numéricos.

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    

Importe 10 filas de las primeras 5 variables de la hoja de cálculo denominada '2007'.

M = readmatrix('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:E11')

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

Argumentos de entrada

filename — Nombre del archivo que se desea leer

vector de caracteres | escalar de cadena

Nombre del archivo que se desea leer, especificado como vector de caracteres o escalar de cadena.

En función de la ubicación del archivo, filename puede tomar una de estas formas.

Ubicación	Forma
Carpeta actual o carpeta en la ruta de MATLAB®	Especifique el nombre del archivo en filename. Ejemplo: 'myFile.txt'
Archivo en una carpeta	Si el archivo no está en la carpeta actual o en una carpeta de la ruta de MATLAB, especifique el nombre de la ruta completa o relativa en filename. Ejemplo: 'C:\myFolder\myFile.xlsx' Ejemplo: 'dataDir\myFile.txt'
URL de Internet	Si el archivo se especifica como un localizador uniforme de recursos de Internet (URL), filename debe contener el tipo de protocolo 'http://' o 'https://'. Ejemplo: 'http://hostname/path_to_file/my_data.csv'
Ubicación remota	Si el archivo está almacenado en una ubicación remota, filename debe contener la ruta completa del archivo especificado con el formato siguiente: scheme_name://path_to_file/my_file.ext Según la ubicación remota, scheme_name puede ser uno de los valores de esta tabla. Ubicación remota scheme_name Amazon S3™ s3 Windows Azure® Blob Storage wasb, wasbs HDFS™ hdfs Para obtener más información, consulte Trabajar con datos remotos. Ejemplo: 's3://bucketname/path_to_file/my_file.csv'

• Si filename incluye la extensión del archivo, la función de importación determina el formato del archivo desde la extensión. De lo contrario, debe especificar los argumentos de par nombre-valor 'FileType' para indicar el tipo de archivo.

• En los sistemas Windows^® con el software Excel^® de Microsoft^®, la función de importación lee cualquier formato de archivo de hoja de cálculo de Excel reconocido por la versión de Excel.

• Si el sistema no dispone de Excel para Windows o si está utilizando MATLAB Online™, la función de importación opera con la función de UseExcel establecida en false, y únicamente lee .xls, .xlsx, .xlsm, .xltx, and .xltm.

• Para archivos de texto delimitado, la función de importación convierte los campos vacíos en el archivo bien a NaN (para una variable numérica) o a un vector de caracteres vacío (para una variable de texto). Todas las líneas en el archivo de texto deben tener el mismo número de delimitadores. La función de importación ignora los espacios en blanco irrelevantes en el archivo.

Tipos de datos: char | string

opts — Opciones de importación de archivo

SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions | XMLImportOptions

Opciones de importación de archivo, especificadas como un objeto SpreadsheetImportOptions, DelimitedTextImportOptions, FixedWidthImportOptions, o un objeto XMLImportOptions creado por la función detectImportOptions. El objeto opts contiene propiedades que controlan el proceso de importación de datos. Para obtener más información acerca de las propiedades de cada objeto, consulte la página del objeto apropiada.

Tipos de archivos	Salida
Archivos de hoja de cálculo	Objeto SpreadsheetImportOptions (solo disponible para las propiedades Sheet, DataRange y VariableNames)
Archivos de texto	objeto DelimitedTextImportOptions
Archivos de texto con ancho fijo	objeto FixedWidthImportOptions
Archivos XML	objeto XMLImportOptions

Para obtener más información acerca de cómo controlar la importación, consulte Control How MATLAB Imports Your Data.

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: 'NumHeaderLines',5 indica que las primeras cinco líneas que preceden a los datos tabulares son líneas de encabezado.

Todos los tipos de archivos admitidos

WebOptions — Opciones de solicitud HTTP o HTTPS

objeto weboptions

Opciones de solicitud HTTP o HTTPS, especificadas como un objeto weboptions. El objeto weboptions determina cómo importar datos cuando el filename especificado es una URL de Internet que contiene el tipo de protocolo "http://" o "https://".

Archivos de texto y de hoja de cálculo

FileType — Tipo de archivo

'text' | 'spreadsheet'

Tipo de archivo, especificado como el par separado por comas que consta de 'FileType' y 'text' o 'spreadsheet'.

Especifique el argumento de par nombre-valor 'FileType' cuando el filename no incluya la extensión del archivo o si la extensión no es ninguna de las siguientes:

• .txt, .dat, o .csv para los archivos de texto delimitados

• .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, o .ods para los archivos de hoja de cálculo

Ejemplo: 'FileType','text'

Tipos de datos: char | string

NumHeaderLines — Número de líneas del encabezado

entero positivo

Número de líneas del encabezado en el archivo, especificado como el par separado por comas que consta de 'NumHeaderLines' y un entero positivo. Si no se especifica, la función de importación detecta automáticamente el número de líneas de encabezado en el archivo.

Ejemplo: 'NumHeaderLines',7

Tipos de datos: single | double

ExpectedNumVariables — Número de variables esperadas

entero positivo

Número de variables esperadas, especificado como el par separado por comas que consta de 'ExpectedNumVariables' y un entero positivo. Si no se especifica, la función de importación detecta automáticamente el número de variables.

Tipos de datos: single | double

Range — Parte de los datos que se desea leer

vector de caracteres | escalar de cadena | vector numérico

Parte de los datos que se desea leer de los archivos de texto u hoja de cálculo, especificada como el par separado por comas, que consta de 'Range' y un vector de caracteres, escalar de cadena o vector numérico en una de esas formas.

Maneras de especificar Range	Descripción
Celda inicial 'Cell' o [row col]	Especifica la celda inicial para los datos como vector de caracteres, escalar de cadena o vector numérico de dos elementos. Vector de caracteres o escalar de cadena que contienen una letra de columna y un número de fila utilizando la notación Excel A1. Por ejemplo, A5 es el identificador para la celda en la intersección de la columna A y la fila 5. Un vector numérico de dos elementos con el formato [row col] indicando la fila y columna iniciales. Utilizando la celda inicial, la función de importación detecta automáticamente la extensión de los datos al comenzar la importación desde la celda inicial y terminando en la última fila vacía o rango del pie de página. Por ejemplo: 'A5' o [5 1]
Rango rectangular 'Corner1:Corner2' o [r1 c1 r2 c2]	Especifica el rango exacto que se desea leer utilizando el rango rectangular en una de estas formas. 'Corner1:Corner2': especifica el rango utilizando Corner1 y Corner2, que son dos esquinas opuestas que definen la región que se desea leer en la notación de Excel A1. Por ejemplo, 'C2:N15'. [r1 c1 r2 c2]: especifica el rango utilizando un vector numérico de cuatro elementos que contenga fila de inicio, columna de inicio, fila final y columna final. Por ejemplo, [2 3 15 13]. La función de importación solo lee los datos que contiene el rango especificado. Cualquier campo vacío dentro del rango especificado se importará como celdas faltantes.
Rango de la fila o rango de la columna 'Row1:Row2' o 'Column1:Column2'	Especifica el rango identificando las filas de comienzo y final utilizando los números de fila de Excel. Al utilizar el rango de fila específico, la función de importación detecta automáticamente la extensión de la columna leyendo la primera columna no vacía hasta el final de los datos, y crea una variable por columna. Ejemplo: '5:500' De forma alternativa, especifica el rango identificando las columnas de comienzo y final utilizando las letras o números de columna de Excel. Al utilizar el rango de columna específico, la función de importación detecta automáticamente la extensión de la fila leyendo desde la primera fila no vacía hasta el final de los datos o el rango del pie de página. El número de columnas en el rango especificado debe coincidir con el número especificado en la propiedad ExpectedNumVariables. Ejemplo: 'A:K'
Número de fila inicial n	Especifica la primera fila que contiene datos utilizando el índice de fila escalar positivo. Al utilizar el índice de fila específico, la función de importación detecta automáticamente la extensión de los datos leyendo desde la primera fila especificada hasta el final de los datos o el rango del pie de página. Ejemplo:5
Rango denominado de Excel 'NamedRange'	En Excel, podrá crear nombres para identificar rangos en la hoja de cálculo. Por ejemplo, puede seleccionar una porción rectangular de la hoja de cálculo y llamarla 'myTable'. Si esos rangos específicos existen en una hoja de cálculo, la función de importación puede leer ese rango utilizando su nombre. Ejemplo: 'Range','myTable'
Sin especificar o vacío ''	Si no se especifica, la función de importación detectará automáticamente el rango utilizado. Ejemplo: 'Range','' Nota: Rango utilizado se refiere a la porción rectangular de la hoja de cálculo que sí contiene datos. La función de importación detectará automáticamente el rango utilizado recortando filas iniciales o finales, así como las columnas que no contienen datos. El texto que está en blanco se considerará como datos y se capturará dentro del rango utilizado.

Tipos de datos: char | string | double

TreatAsMissing — Texto que se desea interpretar como datos faltantes

vector de caracteres | escalar de cadena | arreglo de celdas de vectores de caracteres | arreglo de cadenas

Texto que se desea interpretar como datos faltantes, especificado como vector de caracteres, escalar de cadena, arreglo de celdas de vectores de caracteres o arreglo de cadenas.

Ejemplo: 'TreatAsMissing',{'NA','TBD'} indica a la función de importación que trate cualquier instancia de NA o TBD como campo faltante.

Tipos de datos: char | string | cell

OutputType — Tipo de datos de salida

vector de caracteres | escalar de cadena

Tipo de datos de salida, especificado como el par separado por comas que consta de 'OutputType' y un vector de caracteres o un escalar de cadena que contiene cualquier nombre de los tipos de datos en esta tabla.

Tipo de datos	Tipo de datos de salida
Numérica	'uint8', 'int8', 'int16', 'int32', 'int64', 'uint16', 'uint32', 'uint64', 'single', o 'double'
Texto	'char' o 'string'
Otros tipos	'datetime', 'duration' o 'categorical'

Ejemplo: 'OutputType','uint8'

Tipos de datos: char | string

Solo archivos de texto

Delimiter — Caracteres delimitadores de campo

arreglo de cadenas | vector de caracteres | arreglo de celdas de vectores de caracteres

Caracteres delimitadores de campo en un archivo de texto delimitado, especificados como arreglo de cadenas, vector de caracteres o arreglo de celdas de vectores de caracteres.

Ejemplo: "Delimiter","|"

Ejemplo: "Delimiter",[";","*"]

Whitespace — Caracteres que se desea tratar como espacio en blanco

vector de caracteres | escalar de cadena

Caracteres que se desea tratar como espacio en blanco, especificados como vector de caracteres o escalar de cadena que contienen uno o más caracteres.

Ejemplo: 'Whitespace',' _'

Ejemplo: 'Whitespace','?!.,'

LineEnding — Caracteres de final de línea

["\n","\r","\r\n"] (predeterminado) | arreglo de cadenas | vector de caracteres | arreglo de celdas de vectores de caracteres

Caracteres de final de línea, especificados como arreglo de cadenas, vector de caracteres o arreglo de celdas de vectores de caracteres.

Ejemplo: "LineEnding","\n"

Ejemplo: "LineEnding","\r\n"

Ejemplo: "LineEnding",["\b",":"]

CommentStyle — Estilo de los comentarios

arreglo de cadenas | vector de caracteres | arreglo de celdas de vectores de caracteres

Estilo de los comentarios, especificado como arreglo de cadenas, vector de caracteres o arreglo de celdas de vectores de caracteres. Para comentarios de una y de varias líneas, el identificador de salida debe ser el primer carácter que no está en blanco. Para los comentarios de una línea, especifique un identificador único para tratar las líneas que comiencen con el identificador como comentarios. Para los comentarios de más de una línea, las líneas desde el identificador de salida (primera) hasta el identificador final (segunda) se tratan como comentarios. No se pueden especificar más de dos vectores de caracteres de identificadores.

Por ejemplo, para ignorar la línea que sigue a un símbolo de porcentaje como el primer carácter que no está en blanco, especifique CommentStyle como "%".

Ejemplo: "CommentStyle",["/*"]

Ejemplo: "CommentStyle",["/*","*/"]

Encoding — Esquema de codificación de caracteres

'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

Esquema de codificación de caracteres asociado al archivo, especificado como el par separado por comas que consta de 'Encoding' y 'system' o un nombre de esquema de codificación de caracteres estándar. Cuando no se especifica ninguna codificación, la función readmatrix utiliza la detección automática del conjunto de caracteres para determinar la codificación al leer el archivo.

Si especifica el argumento 'Encoding' además de las opciones de importación, la función readmatrix utiliza el valor especificado para 'Encoding', anulando la codificación definida en las opciones de importación.

Ejemplo: 'Encoding','UTF-8' utiliza UTF-8 como codificación.

Ejemplo: 'Encoding','system' utiliza la codificación predeterminada del sistema.

Tipos de datos: char | string

DateLocale — Configuración local para leer fechas

vector de caracteres | escalar de cadena

Configuración local para leer fechas, especificada como el par separado por comas que consta de 'DateLocale' y un vector de caracteres o un escalar de cadena con el formato xx_YY, donde:

• YY es un código ISO 3166-1 alpha-2 de dos letras mayúsculas que indica un país.

• xx es un código ISO 639-1 de dos letras minúsculas que indica un idioma.

Esta tabla enumera algunos valores comunes para la configuración local.

Configuración local	Lenguaje	País
'de_DE'	Alemán	Alemania
'en_GB'	Inglés	Reino Unido
'en_US'	Inglés	Estados Unidos
'es_ES'	Español	España
'fr_FR'	Francés	Francia
'it_IT'	Italiano	Italia
'ja_JP'	Japonés	Japón
'ko_KR'	Coreano	Corea
'nl_NL'	Holandés	Holanda
'zh_CN'	Chino (simplificado)	China

Al utilizar el especificador de formato %D para leer texto como valores datetime, utilice DateLocale para especificar la configuración local en la que la función de importación debería interpretar los nombres y abreviaciones del mes y día de la semana.

Si especifica el argumento DateLocale además de las opciones de importación opts, la función de importación utiliza el valor especificado para el argumento DateLocale, anulando la configuración local definida en las opciones de importación.

Ejemplo: 'DateLocale','ja_JP'

DecimalSeparator — Caracteres que indican un separador decimal

vector de caracteres | escalar de cadena

Caracteres que indican el separador decimal en variables numéricas, especificados como vector de caracteres o escalar de cadena. La función de importación utiliza los caracteres especificados en el par nombre-valor DecimalSeparator para distinguir la parte del entero de la parte decimal.

Al convertir a tipos de datos de valor entero, los números con una parte decimal se redondean al entero más próximo.

Ejemplo: Si el par nombre-valor se especifica como 'DecimalSeparator',',', la función de importación importa el texto "3,14159" como el número 3.14159.

Tipos de datos: char | string

ThousandsSeparator — Caracteres que indican agrupación de miles

vector de caracteres | escalar de cadena

Caracteres que indican agrupación de miles en variables numéricas, especificados como vector de caracteres o escalar de cadena. Los caracteres de agrupación de miles actúan como separadores visuales, agrupando el número en cada tres valores de posición. La función de importación utiliza los caracteres especificados en el par nombre-valor ThousandsSeparator para interpretar los números que se importan.

Ejemplo: Si el par nombre-valor se especifica como 'ThousandsSeparator',',', la función de importación importa el texto "1,234,000" como 1234000.

Tipos de datos: char | string

TrimNonNumeric — Eliminar caracteres no numéricos

false (predeterminado) | true

Eliminar caracteres no numéricos de una variable numérica, especificado como true o false lógico.

Ejemplo: Si el par nombre-valor se especifica como 'TrimNonNumeric',true, la función de importación lee '$500/-' como 500.

Tipos de datos: logical

ConsecutiveDelimitersRule — Procedimiento para gestionar delimitadores consecutivos

"split" | "join" | "error"

Procedimiento para gestionar delimitadores consecutivos en un archivo de texto delimitado, especificado como uno de los valores de esta tabla.

Valor	Comportamiento
"split"	Divide los delimitadores consecutivos en varios campos.
"join"	Combina los delimitadores en uno solo.
"error"	Devuelve un error y cancela la operación de importación.

LeadingDelimitersRule — Procedimiento para gestionar delimitadores delanteros

"keep" | "ignore" | "error"

Procedimiento para gestionar delimitadores delanteros en un archivo de texto delimitado, especificado como uno de los valores de esta tabla.

Valor	Comportamiento
"keep"	Mantiene el delimitador.
"ignore"	Ignora el delimitador.
"error"	Devuelve un error y cancela la operación de importación.

TrailingDelimitersRule — Procedimiento para gestionar delimitadores finales

'keep' | 'ignore' | 'error'

Procedimiento para gestionar delimitadores finales en un archivo de texto delimitado, especificado como uno de los valores de esta tabla.

Regla de los delimitadores delanteros	Comportamiento
'keep'	Mantiene el delimitador.
'ignore'	Ignora el delimitador.
'error'	Devuelve un error y aborta la operación de importación.

Solo archivos de hoja de cálculo

Sheet — Hoja desde la que se desea leer

'' arreglo de caracteres vacío (predeterminado) | vector de caracteres | escalar de cadena | entero escalar positivo

Hoja desde la que se desea leer, especificada como un arreglo de caracteres vacíos, un vector de caracteres o escalar de cadena que contiene el nombre de la hoja, o un entero escalar positivo que denota el índice de la hoja. Según el valor especificado para la propiedad Sheet, la función de importación se comportará como se describe en la tabla.

Especificación	Comportamiento
'' (valor predeterminado)	Importa datos de la primera hoja.
Nombre	Importa datos desde la hoja de cálculo con el nombre que coincida, independientemente del orden de páginas en el archivo de hoja de cálculo.
Valor entero	Importa datos desde la página en la posición indicada por el entero, independientemente de los nombres de hoja en el archivo de hoja de cálculo.

Tipos de datos: char | string | single | double

UseExcel — Indicador para comenzar una instancia de Microsoft Excel para Windows

false (predeterminado) | true

Indicador para comenzar una instancia de Microsoft Excel para Windows al leer datos de hoja de cálculo, especificado como el par separado por comas que consta de 'UseExcel' y true o false.

Puede establecer el parámetro 'UseExcel' en uno de estos valores:

• true: la función de importación comienza una instancia de Microsoft Excel al leer el archivo.

• false: la función de importación no comienza una instancia de Microsoft Excel al leer el archivo. Al operar en este modo, la funcionalidad de la función de importación varía en la compatibilidad de los formatos de archivo y características interactivas, como fórmulas y macros.

UseExcel	true	false
Formatos de archivo compatibles	.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods	.xls, .xlsx, .xlsm, .xltx, .xltm
Soporte para funcionalidades interactivas, como fórmulas y macros	Sí	No

Al leer desde archivos de hojas de cálculo en plataformas de Windows, si desea comenzar una instancia de Microsoft Excel, establezca el parámetro 'UseExcel' en true.

UseExcel no es compatible en entornos automatizados no interactivos.

Historial de versiones

Introducido en R2019a

Consulte también

readtable | readtimetable | readvars | readcell | writematrix

Temas

• Control How MATLAB Imports Your Data