Main Content

setvaropts

변수에 대한 가져오기 옵션 설정

설명

opts = setvaropts(opts,Name,Value)Name,Value 인수에 포함된 조건을 기반으로 하여 opts 객체에 포함된 모든 변수를 업데이트하고 opts 객체를 반환합니다.

예제

opts = setvaropts(opts,selection,Name,Value)Name,Value 인수에 포함된 조건을 기반으로 하여 selection 인수에 지정된 변수에 대한 opts 객체를 업데이트하고 반환합니다.

예제

모두 축소

import options 객체를 생성하고, 선택한 변수에 대한 옵션을 설정하고, 조정된 옵션과 readtable 함수를 사용하여 데이터를 가져옵니다.

스프레드시트 patients.xls에 대한 옵션 객체를 생성합니다.

opts = detectImportOptions('patients.xls');

Smoker, Diastolic, Systolic 변수에 대한 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'Smoker','FillValue',false);
opts = setvaropts(opts,{'Diastolic','Systolic'},'FillValue',0);

가져올 변수를 선택합니다.

opts.SelectedVariableNames = {'Smoker','Diastolic','Systolic'};

변수를 가져오고 요약을 표시합니다.

T = readtable('patients.xls',opts); 
summary(T) 
Variables:

    Smoker: 100x1 logical

        Values:

            True        34   
            False       66   

    Diastolic: 100x1 double

        Values:

            Min           68  
            Median      81.5  
            Max           99  

    Systolic: 100x1 double

        Values:

            Min         109   
            Median      122   
            Max         138   

누락된 필드나 불완전 필드를 가지는 데이터를 가져오려면 누락된 인스턴스를 인식하고 누락된 인스턴스를 가져올 방법을 결정해야 합니다. importOptions를 사용하여 이러한 경우를 모두 포착하고 readtable을 사용하여 데이터를 가져옵니다.

파일에 대한 import options 객체를 생성하고, 누락된 데이터 가져오기를 제어하는 속성을 업데이트하고, readtable을 사용하여 데이터를 가져옵니다. 참고로, 데이터셋 airlinesmall_subset.csvNA로 지정된 누락된 데이터를 포함하는 두 개의 숫자형 변수 ArrDelayDepDelay를 가집니다.

airlinesmall_subset_NA_screenshot.png

파일에서 import options 객체를 생성합니다.

opts = detectImportOptions("airlinesmall_subset.csv");

TreatAsMissing 속성을 사용하여 데이터에서 누락된 인스턴스로 간주할 자리 표시자 문자를 지정합니다. 이 예제에서 두 개의 숫자형 변수 ArrDelayDepDelay에는 텍스트 NA를 포함하는 누락된 필드가 있습니다.

opts = setvaropts(opts,["ArrDelay","DepDelay"],"TreatAsMissing","NA");

누락된 인스턴스를 가져올 때 가져오기 함수가 취할 동작을 지정합니다. 추가 옵션은 ImportOptions 속성 페이지를 참조하십시오.

opts.MissingRule = "fill";

가져오기 함수가 누락된 인스턴스를 발견할 경우 사용할 값을 지정합니다. 여기서는 변수 ArrDelayDepDelay에서 누락된 인스턴스가 0으로 대체됩니다.

opts = setvaropts(opts,["ArrDelay","DepDelay"],"FillValue",0);

작업할 변수를 선택하고 readtable을 사용하여 가져옵니다.

opts.SelectedVariableNames = ["ArrDelay","DepDelay"]; 
T = readtable("airlinesmall_subset.csv",opts);

ArrDelayDepDelay의 값을 검토합니다. 가져오기 함수가 NA로 표시된 누락값을 대체했는지 확인합니다.

T(42:55,:)
ans=14×2 table
    ArrDelay    DepDelay
    ________    ________

        3          -4   
        0          -1   
       11          11   
        0           0   
        0           0   
        0           0   
       -9           5   
       -9          -3   
        2           6   
        0           0   
        1           1   
        0           4   
        9           0   
       -2           4   

readtable 함수는 0x 접두사와 0b 접두사를 통해 자동으로 16진수 숫자와 2진수 숫자를 감지합니다. 접두사가 없는 16진수 숫자와 2진수 숫자를 가져오려면 import options 객체를 사용하십시오.

파일 hexAndBinary.txt에 대한 import options 객체를 만듭니다. 세 번째 열에 0x 접두사가 없는 16진수 숫자가 있습니다.

opts = detectImportOptions('hexAndBinary.txt')
opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
       TrailingDelimitersRule: 'ignore'
                EmptyLineRule: 'skip'
                     Encoding: 'UTF-8'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
                VariableTypes: {'auto', 'auto', 'char' ... and 1 more}
        SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
              VariableOptions: [1-by-4 matlab.io.VariableImportOptions] 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

접두사가 없어도 세 번째 열을 16진수 값으로 가져오도록 지정하려면 setvaropts 함수를 사용하십시오. 세 번째 변수의 변수 유형을 int32로 설정합니다. 세 번째 열을 가져오기 위한 진법을 hex로 설정합니다.

opts = setvaropts(opts,3,'NumberSystem','hex','Type','int32')
opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
       TrailingDelimitersRule: 'ignore'
                EmptyLineRule: 'skip'
                     Encoding: 'UTF-8'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
                VariableTypes: {'auto', 'auto', 'int32' ... and 1 more}
        SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
              VariableOptions: [1-by-4 matlab.io.VariableImportOptions] 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

파일을 읽어서 처음 세 개의 열을 숫자형 값으로 가져옵니다. readtable 함수는 첫 번째 열과 두 번째 열에 16진수 값과 2진수 값이 포함되어 있음을 자동으로 감지합니다. import options 객체는 세 번째 열에도 16진수 값이 포함되어 있음을 지정합니다.

T = readtable('hexAndBinary.txt',opts)
T=3×4 table
    Var1     Var2    Var3        Var4    
    _____    ____    _____    ___________

      255    255     51193    {'Device1'}
      256      4      1471    {'Device2'}
    43981    129     61455    {'Device3'}

setvaropts 함수를 사용하여 텍스트 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, 텍스트 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

patients.xls의 데이터를 미리 봅니다. 열 LastName에 텍스트 데이터가 있는 것을 알 수 있습니다. 여기에는 처음 10개 행의 미리보기만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('patients.xls');

변수 LastName에 대한 VariableImportOptions를 가져오고 검토합니다.

getvaropts(opts,'LastName')
ans = 
  TextVariableImportOptions with properties:

   Variable Properties:
              Name: 'LastName'
              Type: 'char'
         FillValue: ''
    TreatAsMissing: {}
         QuoteRule: 'remove'
          Prefixes: {}
          Suffixes: {}
    EmptyFieldRule: 'missing'

   String Options:
    WhitespaceRule: 'trim'

변수의 데이터형을 string으로 설정합니다.

opts = setvartype(opts,'LastName','string');

누락값을 'NoName'으로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'LastName','FillValue','NoName');

변수의 처음 10개 행에 대한 미리보기를 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = 'LastName';
T = readtable('patients.xls',opts); 
T.LastName(1:10)
ans = 10x1 string
    "Smith"
    "Johnson"
    "Williams"
    "Jones"
    "Brown"
    "Davis"
    "Miller"
    "Wilson"
    "Moore"
    "Taylor"

setvaropts 함수를 사용하여 logical형 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, 논리형 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

airlinesmall_subset.xlsx의 데이터를 미리 봅니다. 열 Cancelled에 논리형 데이터가 있는 것을 알 수 있습니다. 여기에는 행 30~40의 미리보기만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('airlinesmall_subset.xlsx');

변수 Cancelled에 대한 VariableImportOptions를 가져오고 검토합니다.

getvaropts(opts,'Cancelled')
ans = 
  NumericVariableImportOptions with properties:

   Variable Properties:
                  Name: 'Cancelled'
                  Type: 'double'
             FillValue: NaN
        TreatAsMissing: {}
             QuoteRule: 'remove'
              Prefixes: {}
              Suffixes: {}
        EmptyFieldRule: 'missing'

   Numeric Options:
     ExponentCharacter: 'eEdD'
      DecimalSeparator: '.'
    ThousandsSeparator: ''
        TrimNonNumeric: 0
          NumberSystem: 'decimal'

변수의 데이터형을 logical로 설정합니다.

opts = setvartype(opts,'Cancelled','logical');

누락값을 true로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'Cancelled','FillValue',true);

변수의 요약을 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = 'Cancelled';
T = readtable('airlinesmall_subset.xlsx',opts); 
summary(T)
Variables:

    Cancelled: 1338x1 logical

        Values:

            True         29  
            False      1309  

DatetimeVariableImportOptions 속성을 사용하여 datetime형 데이터 가져오기를 제어합니다. 먼저, 파일에 대한 ImportOptions 객체를 가져옵니다. 다음으로, datetime형 변수에 대한 VariableImportOptions를 검토하고 업데이트합니다. 마지막으로, readtable을 사용하여 변수를 가져옵니다.

outages.csv의 데이터를 미리 봅니다. 열 OutageTimeRestorationTime에 날짜/시간 데이터가 있다는 것을 알 수 있습니다. 여기에는 처음 10개 행만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('outages.csv');

datetime형 변수 OutageTimeRestorationTime에 대한 VariableImportOptions를 가져오고 검토합니다.

varOpts = getvaropts(opts,{'OutageTime','RestorationTime'})
varOpts = 
  1x2 DatetimeVariableImportOptions array with properties:

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule
    DatetimeFormat
    DatetimeLocale
    TimeZone
    InputFormat

누락값을 현재 날짜와 시간으로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,{'OutageTime','RestorationTime'},...
                                           'FillValue','now');

두 개의 변수를 선택하여 읽고 미리 봅니다. RestorationTime의 두 번째 행에서 누락값이 현재 날짜와 시간으로 채워져 있는 것을 알 수 있습니다.

opts.SelectedVariableNames = {'OutageTime','RestorationTime'};
T = readtable('outages.csv',opts); 
T(1:10,:)
ans=10×2 table
         OutageTime           RestorationTime   
    ____________________    ____________________

    01-Feb-2002 12:18:00    07-Feb-2002 16:50:00
    23-Jan-2003 00:49:00    25-Jan-2024 22:25:41
    07-Feb-2003 21:15:00    17-Feb-2003 08:14:00
    06-Apr-2004 05:44:00    06-Apr-2004 06:10:00
    16-Mar-2002 06:18:00    18-Mar-2002 23:23:00
    18-Jun-2003 02:49:00    18-Jun-2003 10:54:00
    20-Jun-2004 14:39:00    20-Jun-2004 19:16:00
    06-Jun-2002 19:28:00    07-Jun-2002 00:51:00
    16-Jul-2003 16:23:00    17-Jul-2003 01:12:00
    27-Sep-2004 11:09:00    27-Sep-2004 16:37:00

setvaropts 함수를 사용하여 categorical형 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, categorical형 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

outages.csv의 데이터를 미리 봅니다. 열 RegionCause에 categorical형 데이터가 있는 것을 알 수 있습니다. 다음 표에는 처음 10개 행만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('outages.csv');

변수 RegionCause에 대한 옵션을 가져오고 검토합니다.

getvaropts(opts,{'Region','Cause'})
ans = 
  1x2 TextVariableImportOptions array with properties:

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule
    WhitespaceRule

변수의 데이터형을 categorical로 설정합니다.

opts = setvartype(opts,{'Region','Cause'},'categorical');

누락값을 범주 이름 'Miscellaneous'로 대체하도록 변수의 FillValue 속성을 설정합니다. TreatAsMissing 속성을 'unknown'으로 설정합니다.

opts = setvaropts(opts,{'Region','Cause'},...
                                   'FillValue','Miscellaneous',...
                                   'TreatAsMissing','unknown');

두 개 변수의 요약을 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts); 
summary(T)
Variables:

    Region: 1468x1 categorical

        Values:

            MidWest        142   
            NorthEast      557   
            SouthEast      389   
            SouthWest       26   
            West           354   

    Cause: 1468x1 categorical

        Values:

            Miscellaneous          24   
            attack                294   
            earthquake              2   
            energy emergency      188   
            equipment fault       156   
            fire                   25   
            severe storm          338   
            thunder storm         201   
            wind                   95   
            winter storm          145   

원치 않는 접두사 문자와 접미사 문자를 포함하는 변수를 갖는 테이블 형식 데이터를 가져옵니다. 먼저 import options 객체를 생성하여 데이터를 미리 봅니다. 그런 다음 원하는 변수를 선택하고 해당 변수의 변수 유형과 속성을 설정하여 원치 않는 문자를 제거합니다. 마지막으로 원하는 데이터를 가져옵니다.

파일의 가져오기 옵션을 생성하고 테이블을 미리 봅니다.

filename = 'pref_suff_trim.csv';
opts = detectImportOptions(filename);
preview(filename,opts)
Warning: Column headers from the file were modified to make them valid MATLAB identifiers before creating variable names for the table. The original column headers are saved in the VariableDescriptions property.
Set 'VariableNamingRule' to 'preserve' to use the original column headers as table variable names.
ans=8×5 table
              Time                   DayOfWeek            Power         Total_Fees      Temperature 
    _________________________    _________________    ______________    ___________    _____________

    {'Timestamp:1/1/06 0:00'}    {'& Sun %20'}    {'54.5448 MW'}    {'$1.23'  }    {'-7.2222 C'}
    {'Timestamp:1/2/06 1:00'}    {'& Thu %20'}    {'.3898 MW'  }    {'$300.00'}    {'-7.3056 C'}
    {'Timestamp:1/3/06 2:00'}    {'& Sun %20'}    {'51.6344 MW'}    {'£2.50'  }    {'-7.8528 C'}
    {'Timestamp:1/4/06 3:00'}    {'& Sun %20'}    {'51.5597 MW'}    {'$0.00'  }    {'-8.1778 C'}
    {'Timestamp:1/5/06 4:00'}    {'& Wed %20'}    {'51.7148 MW'}    {'¥4.00'  }    {'-8.9343 C'}
    {'Timestamp:1/6/06 5:00'}    {'& Sun %20'}    {'52.6898 MW'}    {'$0.00'  }    {'-8.7556 C'}
    {'Timestamp:1/7/06 6:00'}    {'& Mon %20'}    {'55.341 MW' }    {'$50.70' }    {'-8.0417 C'}
    {'Timestamp:1/8/06 7:00'}    {'& Sat %20'}    {'57.9512 MW'}    {'$0.00'  }    {'-8.2028 C'}

원하는 변수를 선택하고 선택한 변수의 유형을 지정한 다음 변수 가져오기 옵션 값을 검토합니다.

opts.SelectedVariableNames = {'Time','Total_Fees','Temperature'};
opts = setvartype(opts,'Time','datetime');
opts = setvaropts(opts,'Time','InputFormat','MM/dd/uu HH:mm'); % Specify datetime format
opts = setvartype(opts,{'Total_Fees','Temperature'},'double');
getvaropts(opts,{'Time','Total_Fees','Temperature'})
ans = 
    1×3 VariableImportOptions array with properties:

   Variable Options:
                         (1) |          (2) |           (3)
            Name:     'Time' | 'Total_Fees' | 'Temperature'
            Type: 'datetime' |     'double' |      'double'
       FillValue:        NaT |          NaN |           NaN
  TreatAsMissing:         {} |           {} |            {}
  EmptyFieldRule:  'missing' |    'missing' |     'missing'
       QuoteRule:   'remove' |     'remove' |      'remove'
        Prefixes:         {} |           {} |            {}
        Suffixes:         {} |           {} |            {}

	To access sub-properties of each variable, use getvaropts

변수 가져오기 옵션의 Prefixes 속성, Suffixes 속성, TrimNonNumeric 속성이 변수 Time에서 'Timestamp:'를 제거하고, 변수 Temperature에서 접미사 'C'를 제거하고, 변수 Total_Fees에서 숫자형이 아닌 모든 문자를 제거하도록 설정합니다. 새로운 가져오기 옵션을 갖는 테이블을 미리 봅니다.

opts = setvaropts(opts,'Time','Prefixes','Timestamp:');
opts = setvaropts(opts,'Temperature','Suffixes','C');
opts = setvaropts(opts,'Total_Fees','TrimNonNumeric',true);
preview(filename,opts)
ans=8×3 table
         Time         Total_Fees    Temperature
    ______________    __________    ___________

    01/01/06 00:00       1.23         -7.2222  
    01/02/06 01:00        300         -7.3056  
    01/03/06 02:00        2.5         -7.8528  
    01/04/06 03:00          0         -8.1778  
    01/05/06 04:00          4         -8.9343  
    01/06/06 05:00          0         -8.7556  
    01/07/06 06:00       50.7         -8.0417  
    01/08/06 07:00          0         -8.2028  

readtable을 사용하여 데이터를 가져옵니다.

T = readtable(filename,opts);

빈 필드를 포함하는 파일에 대한 import options 객체를 생성합니다. EmptyFieldRule 파라미터를 사용하여 데이터의 빈 필드에 대한 가져오기를 관리합니다. 먼저 데이터를 미리 본 다음 특정 변수에 대해 EmptyFieldRule 파라미터를 설정합니다. 마지막으로, 모든 변수에 대해 EmptyFieldRule 을 설정하고 데이터를 가져옵니다.

빈 필드를 포함하는 파일에 대한 import options 객체를 생성합니다. preview 함수를 사용하여 테이블의 처음 8개 행을 가져옵니다. EmptyFieldRule의 디폴트 값은 'missing'입니다. 따라서 가져오기 함수는 빈 필드를 누락된 것으로 처리하고 해당 필드를 이 변수의 FillValue 값으로 대체합니다. 세 번째 변수에 대해 VariableOptions를 사용하여 데이터를 미리 봅니다. 이때 preview 함수는 세 번째 변수의 빈 필드를 NaN으로 가져옵니다.

filename = 'DataWithEmptyFields.csv';
opts = detectImportOptions(filename);
opts.VariableOptions(3) % Display the Variable Options for the 3rd Variable
ans = 
  NumericVariableImportOptions with properties:

   Variable Properties:
                  Name: 'Double'
                  Type: 'double'
             FillValue: NaN
        TreatAsMissing: {}
             QuoteRule: 'remove'
              Prefixes: {}
              Suffixes: {}
        EmptyFieldRule: 'missing'

   Numeric Options:
     ExponentCharacter: 'eEdD'
      DecimalSeparator: '.'
    ThousandsSeparator: ''
        TrimNonNumeric: 0
          NumberSystem: 'decimal'

preview(filename,opts)
ans=8×7 table
       Text       Categorical    Double     Datetime       Logical      Duration      String  
    __________    ___________    ______    ___________    __________    ________    __________

    {'abc'   }    {'a'     }        1      14-Jan-0018    {'TRUE'  }    00:00:01    {'abc'   }
    {0x0 char}    {'b'     }        2      21-Jan-0018    {'FALSE' }    09:00:01    {'def'   }
    {'ghi'   }    {0x0 char}        3      31-Jan-0018    {'TRUE'  }    02:00:01    {'ghi'   }
    {'jkl'   }    {'a'     }      NaN      23-Feb-2018    {'FALSE' }    03:00:01    {'jkl'   }
    {'mno'   }    {'a'     }        4              NaT    {'FALSE' }    04:00:01    {'mno'   }
    {'pqr'   }    {'b'     }        5      23-Jan-0018    {0x0 char}    05:00:01    {'pqr'   }
    {'stu'   }    {'b'     }        5      23-Mar-0018    {'FALSE' }         NaN    {'stu'   }
    {0x0 char}    {'a'     }        6      24-Mar-2018    {'TRUE'  }    07:00:01    {0x0 char}

테이블의 두 번째 변수에 대해 EmptyFieldRule을 설정합니다. 먼저 변수를 선택한 다음 EmptyFieldRule'auto'로 설정합니다. 여기서 readtable 함수는 categorical형 변수의 빈 필드를 <undefined>로 가져옵니다.

opts.SelectedVariableNames = 'Categorical'; 
opts = setvartype(opts,'Categorical','categorical'); 
opts = setvaropts(opts,'Categorical','EmptyFieldRule','auto');
T = readtable(filename,opts)
T=10×1 table
    Categorical
    ___________

    a          
    b          
    <undefined>
    a          
    a          
    b          
    b          
    a          
    a          
    <undefined>

그런 다음 테이블의 모든 변수에 대해 EmptyFieldRule 파라미터를 설정합니다. 먼저 변수의 데이터형을 적절히 업데이트합니다. 이 예제에서는 5번째 변수와 7번째 변수의 데이터형을 각각 logicalstring으로 설정합니다. 그런 다음 모든 변수에 대해 EmptyFieldRule'auto'로 설정합니다. 가져오기 함수는 변수의 데이터형을 기준으로 빈 필드를 가져옵니다. 이때 readtable 함수는 logical형 변수의 빈 필드를 0으로 가져오고 categorical형 변수의 빈 필드를 <undefined>로 가져옵니다.

VariableNames = opts.VariableNames;
opts.SelectedVariableNames =  VariableNames; % select all variables
opts = setvartype(opts,{'Logical','String'},{'logical','string'});
opts = setvaropts(opts,VariableNames,'EmptyFieldRule','auto');
T = readtable(filename,opts)
T=10×7 table
       Text       Categorical    Double     Datetime      Logical    Duration     String  
    __________    ___________    ______    ___________    _______    ________    _________

    {'abc'   }    a                 1      14-Jan-0018     true      00:00:01    "abc"    
    {0x0 char}    b                 2      21-Jan-0018     false     09:00:01    "def"    
    {'ghi'   }    <undefined>       3      31-Jan-0018     true      02:00:01    "ghi"    
    {'jkl'   }    a               NaN      23-Feb-2018     false     03:00:01    "jkl"    
    {'mno'   }    a                 4              NaT     false     04:00:01    "mno"    
    {'pqr'   }    b                 5      23-Jan-0018     false     05:00:01    "pqr"    
    {'stu'   }    b                 5      23-Mar-0018     false          NaN    "stu"    
    {0x0 char}    a                 6      24-Mar-2018     true      07:00:01    ""       
    {0x0 char}    a                 7      25-Mar-2018     true      08:00:01    <missing>
    {'xyz'   }    <undefined>     NaN              NaT     true      06:00:01    "xyz"    

EmptyFieldRule 파라미터는 'missing''auto' 외에도 'error'로 설정할 수 있습니다. 'error'로 설정하는 경우 readtable 함수는 ImportErrorRule 파라미터에 지정된 방법에 따라 빈 필드를 가져옵니다.

입력 인수

모두 축소

파일 가져오기 옵션으로, detectImportOptions 함수에 의해 생성된 SpreadsheetImportOptions, DelimitedTextImportOptions 또는 FixedWidthImportOptions 객체로 지정됩니다. opts 객체는 변수 속성, 데이터 위치 속성, 대체 규칙 같은 데이터 가져오기 프로세스를 제어하는 속성을 포함합니다.

선택한 변수로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열, string형 배열, 숫자형 인덱스로 구성된 배열 또는 논리형 배열로 지정됩니다.

변수 이름(또는 인덱스)은 opts 객체의 VariableNames 속성에 포함된 이름의 서브셋이어야 합니다.

예: 'Height'

예: {'Height','LastName'}

예: [5 9]

데이터형: char | string | cell | uint64 | logical

이름-값 인수

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

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

예: opts = setvaropts(opts,'Weight','FillValue',0)은 변수 Weight에 대한 FillValue0으로 설정합니다.

모든 변수 유형의 공통 옵션

모두 축소

변수의 데이터형으로, 표에 나와 있는 데이터형으로 지정됩니다.

데이터형

설명

'char'

'string'

텍스트.

'single'

'double'

단정밀도 또는 배정밀도 부동소수점 숫자.

'int8', 'int16', 'int32', 'int64'

'uint8', 'uint16', 'uint32', 'uint64'

부호가 있는 정수 또는 부호가 없는 정수로, 8비트, 16비트, 32비트 또는 64비트 정수로 저장됩니다.

정수 데이터형은 부동소수점 숫자 NaN, -Inf+Inf에 대응하는 값을 정의하지 않습니다. 따라서 부동소수점 데이터를 정수로 구성된 배열로 가져오면 가져오기 함수가 정의되지 않은 부동소수점 숫자를 다음과 같이 변환합니다.

  • NaN0으로 변환됩니다.

  • -Infintmin 함수를 사용하여 지정된 정수 데이터형의 가장 작은 정수로 변환됩니다.

  • +Infintmax 함수를 사용하여 지정된 정수 데이터형의 가장 큰 정수로 변환됩니다.

'logical'

true 또는 false 값(예: true, false, 1 또는 0).

'datetime'

특정 시간을 지정하는 날짜와 시간(예: 2019년 12월 10일 오전 9시 12분 56초를 지정하는 2019-12-10 09:12:56).

'duration'

시간의 길이(예: 5시간 13분 45초를 지정하는 05:13:45).

'categorical'

범주를 지정하는 숫자형 데이터 또는 텍스트 데이터(예: 3개의 범주 이름을 지정하는 'red', 'green', 'blue').

누락된 데이터에 대한 대체 값으로, 변수의 유형에 따라 문자형 벡터, string형 스칼라, 숫자형 스칼라, 논리값 true 또는 false로 지정됩니다.

변수의 유형설명
텍스트

대체 텍스트로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: 'not applicable'

숫자형

누락된 인스턴스를 대체할 숫자형 스칼라

가져오기 함수는 FillValue에 대한 입력값을 변수의 Type 속성으로 지정된 데이터형으로 변환합니다. 예를 들어, Type 속성값이 uint8이면 가져오기 함수가 FillValue 속성의 값도 uint8로 변환합니다.

예: 0

논리형

true 또는 false.

예: false

datetime형

날짜/시간 데이터를 나타내는 문자형 벡터나 string형 스칼라, 또는 스칼라 값. 유효한 datetime형 입력값에 대한 자세한 내용은 datetime 함수 도움말 페이지를 참조하십시오.

예: 'now'는 누락된 datetime형 인스턴스를 현재 날짜/시간으로 설정합니다.

예: [1998 12 1]은 누락된 datetime형 인스턴스를 1998년 12월 1일로 설정합니다.

duration형

duration형 데이터를 나타내는 문자형 벡터나 string형 스칼라, 또는 스칼라 값. 유효한 duration형 입력값에 대한 자세한 내용은 duration 함수 페이지를 참조하십시오.

예: '12:30:16'은 누락된 duration형 인스턴스를 12시간, 30분, 16초의 duration형 데이터로 설정합니다.

categorical형

대체 범주에 사용할 이름을 포함하는 문자형 벡터 또는 string형 스칼라.

예: 'Miscellaneous'는 categorical형 데이터에서 누락된 인스턴스에 범주 이름 Miscellaneous를 할당합니다.

누락되거나 변환할 수 없거나 오류를 발생시킨 데이터를 가져오도록 지시하려면 FillValue, TreatAsMissing, MissingRule, ErrorRule의 4개 속성을 함께 사용하십시오. 가져오기 함수는 다음과 같은 경우 FillValue 속성에 지정된 값을 사용합니다.

  • 데이터가 TreatAsMissing의 값과 일치하거나 변환할 수 없는 경우.

  • MissingRule 또는 ErrorRulefill로 설정된 경우.

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

가져오기 함수가 누락된 인스턴스를 발견하면 MissingRule 속성의 조건을 사용하여 적합한 동작을 결정합니다.

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

데이터형: char | string | cell

데이터에서 큰따옴표를 관리하는 과정으로, 다음 표에 있는 값 중 하나로 지정됩니다.

따옴표 규칙처리 방법
'remove'

선행 공백을 제거한 후 큰따옴표(")로 문자가 묶여 있으면 가져오기 함수가 여는 큰따옴표와, 닫는 따옴표로 해석되는 그 다음 큰따옴표를 모두 제거합니다.

예: "The" Example TextThe Example Text로 가져옵니다.

예: The "Example" TextThe "Example" Text로 가져옵니다.

두 개의 큰따옴표("") 세트로 문자가 묶여 있으면 가져오기 함수가 처음 두 개의 큰따옴표를 제거합니다.

예: ""abc""abc""로 가져옵니다.

예: "The" "Example" TextThe "Example" Text로 가져옵니다.

예: The "Example" "Text"The "Example" "Text"로 가져옵니다.

문자를 둘러싸는 여는 따옴표와 닫는 따옴표 쌍 다음에 쌍으로 구성되지 않은 단일의 큰따옴표가 오는 경우, 가져오기 함수는 쌍으로 구성되지 않은 이 단일 큰따옴표를 무시합니다.

예: "abc""abc"로 가져옵니다.

예: "abc"def"abcdef"로 가져옵니다.

바깥쪽 큰따옴표 쌍 안에 있는 이스케이프 큰따옴표는 단일 큰따옴표로 대체됩니다.

예: "The ""Example"" ""Text""" The "Example" "Text"로 가져옵니다.

'keep'

모든 따옴표를 유지합니다.

'error'큰따옴표(")로 시작하는 데이터를 변환할 때 오류를 보고합니다. 필드가 따옴표로 묶이면 안 되는 경우 이 설정을 사용하십시오.

데이터형: char | string

데이터의 빈 필드를 관리하는 방법으로, 다음 값 중 하나로 지정됩니다.

  • 'missing' — 빈 필드를 missing 값으로 처리하고 MissingRule 속성에 지정된 방법을 따릅니다.

  • 'error' — 빈 필드를 가져오기 오류로 처리하고 ImportErrorRule 속성에 지정된 방법을 따릅니다.

  • 'auto' — 변수의 데이터형을 기준으로 빈 필드를 가져옵니다. 빈 텍스트 값의 경우 빈(길이가 0임) 문자형 벡터 또는 string형으로 가져옵니다. 빈 categorical형 값의 경우 정의되지 않은 categorical형 값으로 가져옵니다. 그 외 모든 데이터형의 경우 ImportErrorRule 속성에 지정된 방법을 사용하여 가져옵니다.

예: opts = setvaropts(opts,'RestorationTime','EmptyFieldRule','auto');

데이터형: char | string

변수 값의 접두사 위치에서 제거할 텍스트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다.

예: opts = setvaropts(opts,'Var1','Prefixes','$')는 변수 Var1Prefixes 옵션을 설정합니다. Var1이 값 '$500'를 포함하면 readtable은 이것을 '500'으로 읽어 들입니다.

데이터형: char | string | cell

변수 값의 접미사 위치에서 제거할 텍스트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다.

예: opts = setvaropts(opts,'Var1','Suffixes','/-')는 변수 Var1Suffixes 옵션을 설정합니다. Var1이 값 '$500/-'를 포함하면 readtable은 이것을 '$500'로 읽어 들입니다.

데이터형: char | string | cell

텍스트 변수 옵션

모두 축소

텍스트 데이터를 가져올 때 선행 공백과 후행 공백을 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

공백 규칙처리 방법
'trim'

텍스트에서 선행 공백이나 후행 공백을 제거합니다. 내부 공백은 영향을 받지 않습니다.

예: ' World Time ''World Time'으로 가져옵니다.

'trimleading'

선행 공백만 제거합니다.

예: ' World Time ''World Time '으로 가져옵니다.

'trimtrailing'

후행 공백만 제거합니다.

예: ' World Time '' World Time'으로 가져옵니다.

'preserve'

공백을 유지합니다.

예: ' World Time '' World Time '으로 가져옵니다.

데이터형: char | string

숫자형 변수 옵션

모두 축소

지수를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 과학 표기법으로 표현된 숫자의 지수를 나타내는 문자를 ExponentCharacter 속성을 사용하여 인식합니다.

예: varOpts.ExponentCharacter = 'a'인 경우 가져오기 함수가 텍스트 "1.2a3"을 숫자 1200으로 가져옵니다.

데이터형: char | string

숫자형 변수의 소수점 구분 기호를 나타내는 문자로, 문자형 벡터 또는 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

숫자형 변수를 해석하는 시스템으로, 'decimal', 'hex' 또는 'binary'로 지정됩니다.

'NumberSystem'의 값

설명

'decimal'

  • 입력 숫자형 변수의 값을 10진수 값으로 취급합니다.

  • 값이 'Type' 이름-값 쌍으로 지정된 데이터형을 갖는 것으로 해석하거나, 'Type'이 지정되지 않은 경우 'double'형을 갖는 것으로 해석합니다.

'hex'

  • 입력 숫자형 변수의 값을 16진수(16진법) 값으로 취급합니다. 입력값은 접두사로 '0x' 또는 '0X'를 가질 수 있으나, 접두사가 꼭 필요한 것은 아닙니다.

  • 값이 'Type' 이름-값 쌍으로 지정된 정수 데이터형을 갖는 것으로 해석합니다.

'binary'

  • 입력 숫자형 변수의 값을 2진수(2진법) 값으로 취급합니다. 입력값은 접두사로 '0b' 또는 '0B'를 가질 수 있으나, 접두사가 꼭 필요한 것은 아닙니다.

  • 값이 'Type' 이름-값 쌍으로 지정된 정수 데이터형을 갖는 것으로 해석합니다.

논리형 변수 옵션

모두 축소

논리값 true로 처리할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: varOpts.TrueSymbols = {'t','TRUE'}인 경우 가져오기 함수는 tTRUE를 포함하는 모든 필드를 논리값 true로 가져옵니다.

데이터형: char | string | cell

논리값 false로 처리할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: varOpts.FalseSymbols = {'f','FALSE'}인 경우 가져오기 함수는 fFALSE를 포함하는 모든 필드를 논리값 false로 가져옵니다.

데이터형: char | string | cell

대/소문자를 구분할지 여부에 대한 표시자로, 논리값 true 또는 false로 지정됩니다.

입력 데이터를 누락된 값, true, false 중 하나로 해석하기 위해 가져오기 함수는 데이터를 TreatAsMissing, TrueSymbols, FalseSymbols에 지정된 값과 일치시킵니다.

datetime형 변수 옵션

모두 축소

표시 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. DatetimeFormat 속성은 출력값에서 날짜/시간의 표시 형식을 제어합니다. DatetimeFormat을 다음 값 중 하나로 지정합니다.

DatetimeFormat의 값설명

'default'

디폴트 표시 형식을 사용합니다.

'defaultdate'

시간 성분 없이 생성된 datetime형 값의 디폴트 표시 형식을 사용합니다.

'preserveinput'

입력 형식 InputFormat으로 지정된 형식을 사용합니다.

사용자 지정 형식

문자 A-Za-z를 사용하여 DatetimeFormat의 사용자 지정 값을 생성합니다. 이러한 문자는 날짜의 Unicode® LDML(Locale Data Markup Language) 표준에 대응합니다. 비ASCII 문자나 하이픈, 공백, 콜론과 같은 비문자를 포함하여 필드를 구분할 수 있습니다. 문자 A-Za-z를 형식에 리터럴 문자로 포함하려면 문자를 작은따옴표로 묶으십시오.

공장 초기값 형식은 시스템 로캘에 따라 다릅니다. 디폴트 표시 형식을 변경하려면 datetime형의 디폴트 형식 항목을 참조하십시오.

데이터형: char | string

날짜/시간을 나타내는 입력 텍스트 형식으로, 문자 식별자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

다음 표에는 여러 가지 일반적인 입력 형식이 나와 있으며, 뉴욕 시의 날짜 2014년 4월 19일 토요일 9:41:06 PM에 대해 형식이 지정된 입력값의 예를 보여줍니다.

InputFormat의 값예제
'yyyy-MM-dd'2014-04-19
'dd/MM/yyyy'19/04/2014
'dd.MM.yyyy'19.04.2014
'yyyy年 MM月 dd日'2014年 04月 19日
'MMMM d, yyyy'April 19, 2014
'eeee, MMMM d, yyyy h:mm a'Saturday, April 19, 2014 9:41 PM
'MMMM d, yyyy HH:mm:ss Z'April 19, 2014 21:41:06 -0400
'yyyy-MM-dd''T''HH:mmXXX' 2014-04-19T21:41-04:00

유효한 문자 식별자의 전체 목록을 보려면 datetime형 배열의 Format 속성을 참조하십시오.

예: 'InputFormat','eeee, MMMM d, yyyy HH:mm:ss'

데이터형: char | string

날짜를 해석하는 데 사용할 로캘로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. DatetimeLocale 값은 가져오기 함수가 날짜/시간을 나타내는 텍스트를 해석하는 방법을 결정합니다.

DatetimeLocale을 다음 값 중 하나로 설정하십시오.

  • 'system' — 시스템 로캘을 지정합니다.

  • 문자형 벡터 또는 string형 스칼라 — xx_YY 형식을 사용하십시오. 여기서 xx는 언어를 지정하는 ISO 639-1 두 자로 된 코드(소문자)이고, YY는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.

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

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

예: varOpts.DatetimeLocale = 'de_DE'는 날짜/시간 로캘을 독일어로 설정합니다.

참고

Locale 값에 따라 입력값이 해석되는 방식이 결정됩니다. 표시 형식과 언어는 기본 설정 창의 날짜/시간 형식 섹션에 있는 로캘 옵션에 의해 지정됩니다. 디폴트 날짜/시간 로캘을 변경하려면 명령 창 기본 설정 지정하기 항목을 참조하십시오.

데이터형: char | string

표준 시간대로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. TimeZone의 값은 가져오기 함수가 입력 데이터를 해석하는 데 사용하는 표준 시간대를 지정합니다. TimeZone은 출력 배열의 표준 시간대도 지정합니다. 입력 데이터가 표준 시간대를 포함하는 문자형 벡터이면 가져오기 함수는 모든 값을 지정된 표준 시간대로 변환합니다.

TimeZone은 다음 값 중 하나를 사용합니다.

  • ''. 특정 표준 시간대에 속하지 않는 “표준 시간대가 지정되지 않은” datetime형 값을 만들려는 경우 사용합니다.

  • IANA 표준 시간대 데이터베이스의 표준 시간대 지역(예: 'America/Los_Angeles'). 표준 시간대 지역의 이름은 지리적 지역에서 준수하는, UTC와의 표준 오프셋 및 일광 절약 시간제 오프셋에 대한 현재 규칙과 이전 규칙을 고려합니다.

  • +HH:mm 또는 -HH:mm 형식의 ISO 8601 문자형 벡터. 예를 들어, '+01:00'은 UTC로부터의 고정된 오프셋인 표준 시간대를 지정합니다.

  • 'UTC'. 협정 세계시 기준 datetime형 값을 만들려는 경우 사용합니다.

  • 'UTCLeapSeconds'. 윤초(Leap Second)를 고려하는 협정 세계시 기준 datetime형 값을 만들려는 경우 사용합니다.

다음 표에는 IANA 표준 시간대 데이터베이스에 제공된 표준 시간대 지역의 일반적인 이름이 나와 있습니다.

TimeZone의 값UTC 오프셋UTC DST 오프셋
'Africa/Johannesburg'+02:00+02:00
'America/Chicago'−06:00−05:00
'America/Denver'−07:00−06:00
'America/Los_Angeles'−08:00−07:00
'America/New_York'−05:00−04:00
'America/Sao_Paulo'−03:00−02:00
'Asia/Hong_Kong'+08:00+08:00
'Asia/Kolkata'+05:30+05:30
'Asia/Tokyo'+09:00+09:00
'Australia/Sydney'+10:00+11:00
'Europe/London'+00:00+01:00
'Europe/Zurich'+01:00+02:00

지정된 TimeZone이 없는 datetime형 배열은 TimeZone 속성이 특정 표준 시간대로 설정된 배열과 비교하거나 결합할 수 없습니다.

데이터형: char | string

범주 변수 옵션

모두 축소

예상 범주로, 범주 이름 목록을 포함하는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

변환 오류를 피하려면 입력 필드의 이름이 Categories 속성에 지정된 이름 중 하나와 일치해야 합니다.

예: varOpts.Categories = {'BareLand','Forest','Water','Roads','Buildings'};

범주 보호 표시자로, 논리형 true 또는 false로 지정됩니다. 순서형 categorical형 배열의 범주는 항상 보호됩니다. Ordinal 속성이 true로 설정될 경우 Protected의 디폴트 값은 true가 됩니다. 그렇지 않을 경우, Protected의 값은 false가 됩니다. categorical형 배열에 대한 자세한 내용은 categorical 함수 도움말 페이지를 참조하십시오.

수학적 정렬 표시자로, false, true, 0, 1 중 하나로 지정됩니다. categorical형 배열에 대한 자세한 내용은 categorical 함수 도움말 페이지를 참조하십시오.

기간 변수 옵션

모두 축소

duration형 데이터를 나타내는 입력 텍스트의 형식으로, 문자형 벡터 또는 string형 배열로 지정됩니다.

InputFormat을 다음 형식 중 하나로 지정합니다. 여기서 dd, hh, mm, ss는 각각 일, 시, 분, 초를 나타냅니다.

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • 처음 세 형식 중 하나와, 소수 초(Fractional Second) 자릿수를 나타내는 최대 9개의 S 문자를 함께 사용(예: 'hh:mm:ss.SSSS')

예: varOpts.InputFormat = 'dd:hh:mm:ss'

데이터형: char | string

duration형 데이터의 표시 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

시간 단위를 포함한 숫자의 경우, 다음 값 중 하나를 지정하십시오.

  • 'y' — 고정 길이 연 수. 1년은 365.2425일입니다.

  • 'd' — 고정 길이 일 수. 1일은 24시간입니다.

  • 'h' — 시간

  • 'm' — 분

  • 's' — 초

디지털 타이머의 경우, 다음 형식 중 하나를 지정하십시오.

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • 처음 세 형식 중 하나와, 소수 초(Fractional Second) 자릿수를 나타내는 최대 9개의 S 문자를 함께 사용(예: 'hh:mm:ss.SSSS')

예: DurationFormat은 시간 단위를 포함한 단일 숫자(예: 0.5 yr)이거나 디지털 타이머(예: 10:30:15 - 10시간, 30분, 15초)일 수 있습니다.

데이터형: char | string

소수 초를 구분하는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 DecimalSeparator 속성을 사용하여 duration형 값의 정수부와 소수 초 부분을 구분합니다.

데이터형: char | string

duration형 데이터의 필드 구분을 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

데이터형: char | string

버전 내역

R2016b에 개발됨