Main Content

readvars

파일에서 변수 읽어 들이기

R2019a 이후

설명

예제

[Var1,Var2,...,VarN] = readvars(filename)은 파일에서 열 방향 데이터를 읽어 변수를 만듭니다. 파일에 N개의 데이터 열이 있으면 readvarsN개의 변수 Var1,Var2,...,VarN을 반환합니다.

readvars는 다음과 같은 파일 확장자에서 파일 형식을 결정합니다.

  • .txt, .dat, .csv - 기호로 구분된 텍스트 파일

  • .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일

예제

[Var1,Var2,...,VarN] = readvars(filename,opts)는 가져오기 옵션 opts를 추가로 사용합니다.

예제

[Var1,Var2,...,VarN] = readvars(___,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 추가 옵션으로 지정하여 파일에서 변수를 만듭니다. 이름-값 쌍을 지정하기 전에 위에 열거된 구문에 나와 있는 입력 인수를 사용하십시오.

데이터에 대한 특정 가져오기 옵션을 설정하기 위해 opts 객체를 사용하거나 이름-값 쌍을 지정할 수 있습니다. opts에 더해 이름-값 쌍을 지정하는 경우 readvars는 다음과 같은 이름-값 쌍만 지원합니다.

  • 텍스트 파일 — DateLocale, Encoding

  • 스프레드시트 파일 — Sheet, UseExcel

예제

모두 축소

텍스트 파일에서 테이블 형식 데이터의 열을 개별 변수로 가져옵니다. 먼저, 텍스트 파일 outages.csv의 내용을 미리 보고 열을 읽습니다.

outages.csv의 데이터를 미리 봅니다. 파일에는 6개의 변수가 있습니다.

opts = detectImportOptions('outages.csv');
preview('outages.csv',opts)
ans=8×6 table
       Region             OutageTime          Loss     Customers       RestorationTime              Cause       
    _____________    ____________________    ______    __________    ____________________    ___________________

    {'SouthWest'}    01-Feb-2002 12:18:00    458.98    1.8202e+06    07-Feb-2002 16:50:00    {'winter storm'   }
    {'SouthEast'}    23-Jan-2003 00:49:00    530.14    2.1204e+05                     NaT    {'winter storm'   }
    {'SouthEast'}    07-Feb-2003 21:15:00     289.4    1.4294e+05    17-Feb-2003 08:14:00    {'winter storm'   }
    {'West'     }    06-Apr-2004 05:44:00    434.81    3.4037e+05    06-Apr-2004 06:10:00    {'equipment fault'}
    {'MidWest'  }    16-Mar-2002 06:18:00    186.44    2.1275e+05    18-Mar-2002 23:23:00    {'severe storm'   }
    {'West'     }    18-Jun-2003 02:49:00         0             0    18-Jun-2003 10:54:00    {'attack'         }
    {'West'     }    20-Jun-2004 14:39:00    231.29           NaN    20-Jun-2004 19:16:00    {'equipment fault'}
    {'West'     }    06-Jun-2002 19:28:00    311.86           NaN    07-Jun-2002 00:51:00    {'equipment fault'}

처음 3개의 열을 작업 공간에 개별 변수로 가져옵니다.

[Region,OutageTime,Loss] = readvars('outages.csv');
whos Region OutageTime Loss
  Name               Size             Bytes  Class       Attributes

  Loss            1468x1              11744  double                
  OutageTime      1468x1              23488  datetime              
  Region          1468x1             174988  cell                  

스프레드시트 파일의 열을 작업 공간에 개별 변수로 가져옵니다. 먼저, 텍스트 파일 outages.csv의 내용을 미리 보고 열을 개별 변수로 읽습니다.

patients.xls의 데이터를 미리 봅니다. 파일에는 10개의 변수가 있습니다.

opts = detectImportOptions('patients.xls');
preview('patients.xls',opts)
ans=8×10 table
      LastName        Gender      Age              Location               Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    ____________    __________    ___    _____________________________    ______    ______    ______    ________    _________    ________________________

    {'Smith'   }    {'Male'  }    38     {'County General Hospital'  }      71       176      true        124          93             {'Excellent'}      
    {'Johnson' }    {'Male'  }    43     {'VA Hospital'              }      69       163      false       109          77             {'Fair'     }      
    {'Williams'}    {'Female'}    38     {'St. Mary's Medical Center'}      64       131      false       125          83             {'Good'     }      
    {'Jones'   }    {'Female'}    40     {'VA Hospital'              }      67       133      false       117          75             {'Fair'     }      
    {'Brown'   }    {'Female'}    49     {'County General Hospital'  }      64       119      false       122          80             {'Good'     }      
    {'Davis'   }    {'Female'}    46     {'St. Mary's Medical Center'}      68       142      false       121          70             {'Good'     }      
    {'Miller'  }    {'Female'}    33     {'VA Hospital'              }      64       142      true        130          88             {'Good'     }      
    {'Wilson'  }    {'Male'  }    40     {'VA Hospital'              }      68       180      false       115          82             {'Good'     }      

처음 3개의 열을 작업 공간에 개별 변수로 가져옵니다.

[LastName,Gender,Age] = readvars('patients.xls');
whos  LastName Gender Age
  Name            Size            Bytes  Class     Attributes

  Age           100x1               800  double              
  Gender        100x1             11412  cell                
  LastName      100x1             11616  cell                

스프레드시트 파일에서 데이터를 미리 보고 지정된 시트 및 범위에서 데이터의 열을 개별 변수로 가져옵니다.

스프레드시트 파일 airlinesmall_subset.xlsx 에는 1996년~2008년의 데이터가 여러 워크시트에 포함되어 있습니다. 각 워크시트에는 해당 연도에 대한 데이터가 있습니다. airlinesmall_subset.xlsx 파일의 데이터를 미리 봅니다. preview 함수는 기본적으로 첫 번째 워크시트의 데이터를 보여 줍니다.

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}    

이름이 '2007'인 워크시트의 열 56에서 10개의 행을 가져오도록 opts 객체의 값을 구성합니다.

opts.Sheet = '2007';
opts.SelectedVariableNames = [5 6]; 
opts.DataRange = '2:11';
[DepTime,CRSDepTime] = readvars('airlinesmall_subset.xlsx',opts);

변수를 표시합니다.

[DepTime, CRSDepTime]
ans = 10×2

         711         710
         652         655
        1116        1120
         825         825
        1411        1400
        1935        1935
        2005        2005
        1525        1525
        1133        1105
         922         925

스프레드시트 파일에서 데이터를 미리 보고 지정된 시트 및 범위에서 열을 개별 변수로 가져옵니다.

스프레드시트 파일 airlinesmall_subset.xlsx 에는 1996년~2008년의 데이터가 여러 워크시트에 포함되어 있습니다. 각 워크시트에는 해당 연도에 대한 데이터가 있습니다. airlinesmall_subset.xlsx 파일의 데이터를 미리 봅니다. preview 함수는 기본적으로 첫 번째 워크시트의 데이터를 보여 줍니다.

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}    

이름이 '2007'인 워크시트에서 처음 3개 변수에 대한 10개 행을 가져옵니다.

[Year, Month, DayOfMonth] = readvars('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:C11');
whos Year Month DayOfMonth
  Name             Size            Bytes  Class     Attributes

  DayOfMonth      10x1                80  double              
  Month           10x1                80  double              
  Year            10x1                80  double              
disp([Year Month DayOfMonth])
        2007           1           2
        2007           1           3
        2007           1           4
        2007           1           5
        2007           1           7
        2007           1           8
        2007           1           9
        2007           1          11
        2007           1          12
        2007           1          13

입력 인수

모두 축소

읽을 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파일의 위치에 따라 filename은 다음 형식 중 하나가 될 수 있습니다.

위치

형식

현재 폴더 또는 MATLAB® 경로의 폴더

filename에 파일의 이름을 지정합니다.

예: 'myFile.txt'

폴더 안의 파일

파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, filename에 전체 경로 또는 상대 경로 이름을 지정합니다.

예: 'C:\myFolder\myFile.xlsx'

예: 'dataDir\myFile.txt'

인터넷 URL

파일이 인터넷 URL(Uniform Resource Locator)로 지정된 경우, filename은 프로토콜 유형 'http://' 또는 'https://'를 포함해야 합니다.

예: 'http://hostname/path_to_file/my_data.csv'

원격 위치

파일이 원격 위치에 저장된 경우, filename은 다음 형식으로 지정된 파일의 전체 경로를 포함해야 합니다.

scheme_name://path_to_file/my_file.ext

원격 위치에 따라 scheme_name은 다음 표에 있는 값 중 하나가 될 수 있습니다.

원격 위치scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

예: 's3://bucketname/path_to_file/my_file.csv'

  • filename에 파일 확장자가 포함되는 경우 가져오기 함수는 확장자를 통해 파일 형식을 결정하게 됩니다. 파일 형식을 따로 나타내고자 하면 'FileType' 이름-값 쌍의 인수를 지정해야 합니다.

  • Microsoft® Excel® 소프트웨어를 실행하는 Windows® 시스템에서 가져오기 함수는 사용자의 Excel 버전으로 인식되는 모든 Excel 스프레드시트 파일 형식을 읽습니다.

  • 시스템에 Windows용 Excel이 없거나 MATLAB Online™을 사용 중인 경우, 가져오기 함수는 UseExcel 속성이 false로 설정된 상태로 작동하고 .xls, .xlsx, .xlsm, .xltx, and .xltm 파일만 읽습니다.

  • 기호로 구분된 텍스트 파일의 경우, 가져오기 함수는 파일의 빈 필드를 NaN(숫자형 변수의 경우)이나 빈 문자형 벡터(텍스트 변수의 경우)로 변환합니다. 텍스트 파일의 모든 줄에는 동일한 개수의 구분 기호가 있어야 합니다. 가져오기 함수는 파일에서 무의미한 공백을 무시합니다.

데이터형: char | string

파일 가져오기 옵션으로, detectImportOptions 함수에 의해 생성된 SpreadsheetImportOptions 객체, DelimitedTextImportOptions 객체, FixedWidthImportOptions 객체 또는 XMLImportOptions 객체로 지정됩니다. opts 객체에는 데이터 가져오기 과정을 제어하는 속성이 들어 있습니다. 각 객체의 속성에 대한 자세한 내용은 해당 객체 페이지를 참조하십시오.

파일 형식출력값
스프레드시트 파일SpreadsheetImportOptions 객체(Sheet, DataRange, VariableNames 속성의 경우에만 사용 가능)
텍스트 파일DelimitedTextImportOptions 객체
고정 너비 텍스트 파일FixedWidthImportOptions 객체
XML 파일XMLImportOptions 객체

가져오기를 제어하는 방법에 대한 자세한 내용은 Control How MATLAB Imports Your Data 항목을 참조하십시오.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'NumHeaderLines',5는 테이블 형식 데이터 앞에 있는 처음 다섯 줄이 헤더 라인임을 나타냅니다.

지원되는 모든 파일 형식

모두 축소

HTTP 또는 HTTPS 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 객체는 지정된 filename이 프로토콜 유형 "http://" 또는 "https://"를 포함하는 인터넷 URL일 때 데이터를 어떻게 가져올지를 결정합니다.

텍스트 파일과 스프레드시트 파일

모두 축소

파일 형식으로, 'FileType'과 함께 'text''spreadsheet'가 쉼표로 구분되어 지정됩니다.

filename에 파일 확장자가 포함되어 있지 않거나 확장자가 다음 중 하나가 아닌 경우 'FileType' 이름-값 쌍의 인수를 지정하십시오.

  • .txt, .dat, .csv - 기호로 구분된 텍스트 파일

  • .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일

예: 'FileType','text'

데이터형: char | string

파일의 헤더 라인 수로, 'NumHeaderLines'와 함께 양의 정수가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, 가져오기 함수가 자동으로 파일에 있는 헤더 라인 수를 감지합니다.

예: 'NumHeaderLines',7

데이터형: single | double

예상 변수 개수로, 'ExpectedNumVariables'와 함께 양의 정수가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, 가져오기 함수가 자동으로 변수 개수를 감지합니다.

데이터형: single | double

텍스트 또는 스프레드시트 파일에서 읽을 데이터의 부분으로, 'Range'와 함께 다음 형식을 사용하여 문자형 벡터, string형 스칼라 또는 숫자형 벡터가 쉼표로 구분되어 지정됩니다.

Range를 지정하는 방법설명

시작 셀

'Cell' 또는 [row col]

데이터의 시작 셀을 문자형 벡터나 string형 스칼라 또는 요소를 2개 가진 숫자형 벡터로 지정합니다.

  • Excel A1 표기법을 사용하여 열 문자와 행 번호를 포함하는 문자형 벡터나 string형 스칼라를 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

  • 시작 행과 열을 나타내는 [row col] 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다.

가져오기 함수는 시작 셀을 사용하여 시작 셀에서 가져오기를 시작하고 마지막 빈 행이나 푸터 범위에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 검색합니다.

예: 'A5' 또는 [5 1]

사각 범위

'Corner1:Corner2' 또는 [r1 c1 r2 c2]

다음 형식 중 하나로 사각 범위를 사용하여 읽어 들일 정확한 범위를 지정합니다.

  • 'Corner1:Corner2' — 읽을 범위를 정의하는 2개의 끝 지점인 Corner1Corner2를 사용하여 Excel A1 표기법으로 범위를 지정합니다. 예를 들면 'C2:N15'와 같습니다.

  • [r1 c1 r2 c2] — 시작 행, 시작 열, 끝 행, 끝 열을 포함하는 요소를 4개 가진 숫자형 벡터를 사용하여 범위를 지정합니다. 예를 들면 [2 3 15 13]과 같습니다.

가져오기 함수는 지정된 범위에 포함된 데이터만 읽어옵니다. 지정된 범위 내에 있는 모든 빈 필드는 누락된 셀로서 가져옵니다.

행 범위 또는 열 범위

'Row1:Row2' 또는 'Column1:Column2'

Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다.

가져오기 함수는 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색하고 열당 하나의 변수를 생성합니다.

예: '5:500'

또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오.

가져오기 함수는 지정된 열 범위를 사용하여 비어 있지 않은 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 행의 범위를 자동으로 검색합니다.

지정된 범위에 있는 열 개수는 ExpectedNumVariables 속성에 지정된 개수와 일치해야 합니다.

예: 'A:K'

시작 행 번호

n

양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다.

가져오기 함수는 지정된 행 인덱스를 사용하여 지정된 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 데이터의 범위를 자동으로 검색합니다.

예:5

Excel의 명명된 범위

'NamedRange'

Excel의 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 'myTable'이라고 지정할 수 있습니다. 스프레드시트에 이렇게 명명된 범위가 있는 경우 가져오기 함수는 이 이름을 사용하여 범위를 읽을 수 있습니다.

예: 'Range','myTable'

지정되지 않거나 비어 있음

''

지정되지 않은 경우, 가져오기 함수가 자동으로 "사용된 범위"를 감지합니다.

예: 'Range',''

참고: 사용된 범위는 실제로 데이터를 포함하는 스프레드시트의 사각형 부분을 말합니다. 가져오기 함수는 데이터가 들어 있지 않은 모든 선행 행과 열, 후행 행과 열을 잘라내어 자동으로 "사용된 범위"를 감지합니다. 공백만 있는 텍스트는 데이터로 간주되어 "사용된 범위"에 캡처됩니다.

데이터형: char | string | double

가져오는 텍스트 데이터의 유형으로, 다음 값 중 하나로 지정됩니다.

  • "string" — 텍스트 데이터를 string형 배열로 가져옵니다.

  • "char" — 텍스트 데이터를 문자형 벡터로 가져옵니다.

예: "TextType","char"

가져오는 날짜/시간 데이터의 유형으로, 다음 값 중 하나로 지정됩니다.

설명
"datetime"

MATLAB datetime 데이터형

자세한 내용은 datetime을 참조하십시오.

"text"

"DatetimeType""text"로 지정된 경우, 가져오는 날짜/시간 데이터의 유형은 "TextType" 파라미터에 지정된 값에 따라 달라집니다.

  • "TextType""char"로 설정된 경우 가져오기 함수는 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

  • "TextType""string"으로 설정된 경우 가져오기 함수는 날짜를 string형 배열로 반환합니다.

"exceldatenum"

Excel 날짜 일련 번호 값

"exceldatenum"은 스프레드시트 파일에만 적용할 수 있고 텍스트 파일에는 유효하지 않습니다. 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오.

누락된 데이터로 해석할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: 'TreatAsMissing',{'NA','TBD'}는 가져오기 함수에 NA 또는 TBD 인스턴스를 누락된 필드로 처리하도록 지시합니다.

데이터형: char | string | cell

텍스트 파일에만 해당

모두 축소

구분된 텍스트 파일의 필드 구분 기호 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

예: "Delimiter","|"

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

공백으로 처리할 문자로, 하나 이상의 문자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: 'Whitespace',' _'

예: 'Whitespace','?!.,'

라인 끝(EOL) 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

예: "LineEnding","\n"

예: "LineEnding","\r\n"

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

주석 스타일로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 단일 라인 주석과 여러 라인 주석의 경우, 시작 식별자는 공백이 아닌 첫 번째 문자여야 합니다. 단일 라인의 주석에서는 단일 식별자를 지정하여 해당 식별자로 시작하는 라인을 주석으로 처리하십시오. 여러 라인의 주석에서는 시작(첫 번째) 식별자에서 끝(두 번째) 식별자까지의 라인이 주석으로 처리됩니다. 식별자로 구성된 2개 이하의 문자형 벡터만 지정할 수 있습니다.

예를 들어, CommentStyle"%"로 지정하면 공백이 아닌 첫 번째 문자로서의 퍼센트 기호 다음에 오는 라인이 무시됩니다.

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

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

파일과 연결된 문자 인코딩 체계로, 'Encoding'과 함께 'system' 또는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다. 인코딩을 지정하지 않은 경우 readvars 함수는 자동 문자 집합 감지를 사용하여 파일을 읽을 때 사용할 인코딩을 결정합니다.

가져오기 옵션과 함께 'Encoding' 인수를 지정하면 readvars 함수는 'Encoding'에 지정된 값을 사용하고 가져오기 옵션에 정의된 인코딩을 무시합니다.

예: 'Encoding','UTF-8'은 UTF-8을 인코딩으로 사용합니다.

예: 'Encoding','system'은 시스템 디폴트 인코딩을 사용합니다.

데이터형: char | string

텍스트 파일의 지속 시간 데이터의 출력 데이터형으로, 'DurationType'과 함께 'duration'이나 'text'가 쉼표로 구분되어 지정됩니다.

가져온 지속 시간 데이터의 유형
'duration'

MATLAB duration 데이터형

자세한 내용은 duration을 참조하십시오.

'text'

'DurationType''text'로 지정된 경우, 가져온 지속 시간 데이터의 유형은 'TextType' 파라미터에 지정된 값에 따라 달라집니다.

  • 'TextType''char'로 설정된 경우 가져오기 함수는 지속 시간 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

  • 'TextType''string'으로 설정된 경우 가져오기 함수는 지속 시간 데이터를 string형 배열로 반환합니다.

데이터형: char | string

날짜 읽기에 적용할 로캘로, 'DateLocale'과 함께 xx_YY 형식의 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 여기서,

  • YY는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.

  • xx는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)입니다.

다음 표에는 로캘에 일반적으로 사용되는 일부 값이 나와 있습니다.

로캘 언어국가
'de_DE'독일어독일
'en_GB'영어영국
'en_US'영어미국
'es_ES'스페인어스페인
'fr_FR'프랑스어프랑스
'it_IT'이탈리아어이탈리아
'ja_JP'일본어일본
'ko_KR'한국어한국
'nl_NL'네덜란드어네덜란드
'zh_CN'중국어(간체)중국

텍스트를 datetime형 값으로 읽기 위해 %D 형식 지정자를 사용할 때, DateLocale을 사용하여 가져오기 함수가 월과 요일 이름, 약어를 해석해야 하는 로캘을 지정하십시오.

opts 가져오기 옵션과 함께 DateLocale 인수를 지정하면, 가져오기 함수는 DateLocale 인수에 지정된 값을 사용하며 가져오기 옵션에 정의된 로캘을 무시합니다.

예: 'DateLocale','ja_JP'

숫자형 변수의 소수점 구분 기호를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 DecimalSeparator 이름-값 쌍에 지정된 문자를 사용하여 숫자의 정수부와 소수부를 구별합니다.

정수 데이터형으로 변환할 때는 소수부 숫자가 가장 가까운 정수로 반올림됩니다.

예: 이름-값 쌍이 'DecimalSeparator',','로 지정된 경우 가져오기 함수가 텍스트 "3,14159"를 숫자 3.14159로 가져옵니다.

데이터형: char | string

숫자형 변수의 천 단위 구분을 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 천 단위 구분 문자는 매 세 자리값에서 숫자를 분류하는 시각적 구분 기호로 동작합니다. 가져오기 함수는 ThousandsSeparator 이름-값 쌍에 지정된 문자를 사용하여 가져올 숫자를 해석합니다.

예: 이름-값 쌍이 'ThousandsSeparator',','로 지정된 경우 가져오기 함수가 텍스트 "1,234,000"1234000으로 가져옵니다.

데이터형: char | string

숫자형 변수에서 숫자형이 아닌 문자를 제거하며, 논리형 true 또는 false로 지정됩니다.

예: 이름-값 쌍이 'TrimNonNumeric',true로 지정된 경우 가져오기 함수가 '$500/-'500으로 읽습니다.

데이터형: logical

구분된 텍스트 파일의 연속된 구분 기호를 관리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

동작
"split"연속된 구분 기호를 여러 개의 필드로 분할합니다.
"join"여러 구분 기호를 하나의 구분 기호로 결합합니다.
"error"오류를 반환하고 가져오기 작업을 취소합니다.

구분된 텍스트 파일의 선행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

동작
"keep"구분 기호를 유지합니다.
"ignore"구분 기호를 무시합니다.
"error"오류를 반환하고 가져오기 작업을 취소합니다.

구분된 텍스트 파일의 후행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

선행 구분 기호 규칙동작
'keep'구분 기호를 유지합니다.
'ignore'구분 기호를 무시합니다.
'error'오류를 반환하고 가져오기 작업을 중단합니다.
스프레드시트 파일만 해당

모두 축소

읽어 들일 시트로, 빈 문자형 배열, 시트 이름을 포함하는 문자형 벡터나 string형 스칼라 또는 시트 인덱스를 나타내는 양의 정수 스칼라로 지정됩니다. Sheet 속성에 지정된 값에 따라 가져오기 함수는 아래 표에 설명된 대로 동작합니다.

지정값동작
''(디폴트 값)첫 번째 시트에서 데이터를 가져옵니다.
이름스프레드시트 파일의 시트 순서와 상관없이 일치하는 시트 이름에서 데이터를 가져옵니다.
정수스프레드시트 파일의 시트 이름과 상관없이 정수로 나타내어진 위치에 있는 시트에서 데이터를 가져옵니다.

데이터형: char | string | single | double

스프레드시트 데이터를 읽을 때 Windows용 Microsoft Excel을 시작할지 지정하는 플래그로, 'UseExcel'과 함께 true 또는 false가 쉼표로 구분되어 지정됩니다.

'UseExcel' 파라미터는 다음 값 중 하나로 설정할 수 있습니다.

  • true — 파일을 읽을 때 가져오기 함수가 Microsoft Excel을 시작합니다.

  • false — 파일을 읽을 때 가져오기 함수가 Microsoft Excel을 시작하지 않습니다. 이 모드에서 작업할 때 가져오기 함수는 파일 형식 지원과 수식이나 매크로 같은 대화형 기능 지원 면에서 다르게 동작합니다.

UseExcel

true

false

지원되는 파일 형식

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls, .xlsx, .xlsm, .xltx, .xltm

수식이나 매크로 같은 대화형 기능 지원

아니요

Windows 플랫폼에서 스프레드시트 파일을 읽을 때 Microsoft Excel 인스턴스를 시작하지 않으려면 'UseExcel' 파라미터를 true로 설정하십시오.

버전 내역

R2019a에 개발됨