【注】詳情請參閱 MatLab help 文檔刊棕。

1. datetime 函數(shù)

1.1 作用

datetime 用來創(chuàng)建表示時間點的數(shù)組（數(shù)組元素類型為 datetime）炭晒。

1.2 語法

t = datetime
t = datetime(relativeDay)
t = datetime(DateString)
t = datetime(DateStrings,'InputFormat',infmt)
t = datetime(DateVectors)
t = datetime(Y,M,D)
t = datetime(Y,M,D,H,MI,S)
t = datetime(Y,M,D,H,MI,S,MS)
t = datetime(X,'ConvertFrom',dateType)
t = datetime(___,Name,Value)

• t = datetime
  獲取當前日期和時間的標量 datetime 數(shù)組。

• t = datetime(relativeDay)
  獲取 relativeDay 指定日期的 datetime 數(shù)組甥角。

• t = datetime(DateString)
  根據(jù)表示時間點的 DateStrings 中的文本創(chuàng)建一個日期時間值數(shù)組腰埂，datetime 函數(shù)會嘗試將 DateStrings 的格式與常用格式進行匹配。

DateStrings 常用文本格式如下：

可用于構(gòu)造日期和時間格式的標識符如下：

時區(qū)偏移量格式如下：

• t = datetime(DateStrings,'InputFormat',infmt)
  使用 infmt 指定的格式來解釋 DateStrings（DateStrings 中的所有值必須具有相同格式）担扑。infmt 可選值參見上文恰响。

• t = datetime(DateVectors)
  根據(jù) DateVectors 中的日期向量創(chuàng)建一個由日期時間值組成的列向量。DateVectors 指定為 或 矩陣涌献，分別包含 個完全或部分日期向量胚宦。完整日期向量帶有六個元素，依順序分別指示年燕垃、月枢劝、日、時卜壕、分您旁、秒。部分日期向量指代有三個元素轴捎，依順序分別指示年鹤盒、月、日轮蜕。DateVectors 的每個元素應為正整數(shù)或負整數(shù)值昨悼，秒元素可以為小數(shù)。如果某元素不在常規(guī)范圍之內(nèi)跃洛，則 datetime 會同時調(diào)整該日期向量元素及其前面的元素率触。

• t = datetime(Y,M,D)
  為 Y、M汇竭、D 數(shù)組對應的元素創(chuàng)建一個日期時間值數(shù)組（Y葱蝗、M穴张、D 數(shù)組大小必須一致，或者其中任一數(shù)組可以是標量）两曼。也可以將輸入?yún)?shù)指定為日期向量 [Y M D] 皂甘。

• t = datetime(Y,M,D,H,MI,S)
  為 Y、M悼凑、D偿枕、H、MI户辫、S 數(shù)組對應的元素創(chuàng)建一個日期時間值數(shù)組（Y渐夸、M、D渔欢、H墓塌、MI、S 數(shù)組大小必須一致奥额，或者其中任一數(shù)組可以是標量）苫幢。也可以將輸入?yún)?shù)指定為日期向量 [Y M D H MI S] 。

• t = datetime(Y,M,D,H,MI,S,MS)
  為 Y垫挨、M韩肝、D、H棒拂、MI伞梯、S、MS 數(shù)組對應的元素創(chuàng)建一個日期時間值數(shù)組（Y帚屉、M谜诫、D、H攻旦、MI喻旷、S、MS 數(shù)組大小必須一致牢屋，或者其中任一數(shù)組可以是標量）且预。

• t = datetime(X,'ConvertFrom',dateType)
  將 X 中的數(shù)值轉(zhuǎn)換為 datetime 數(shù)組 t。dateType 參數(shù)指定 X 中的值的類型烙无。dateType 的可選值如下：

【注】

1. Excel 錯誤地假設 1900 年是閏年。因此截酷，計算 Excel 日期數(shù)字時涮拗，1900 年 2 月 28 日與 1900 年 3 月 1 日之間因為多了一天而中斷。
2. 如果將 X 轉(zhuǎn)換為 datetime 數(shù)組而不指定時區(qū)，則 datetime 值表示 UTC 時間三热，而不是本地時間鼓择。要表示本地時間，請使用 'TimeZone' 名稱-值對組參數(shù)指定時區(qū)（見下文）就漾。

• t = datetime(___,Name,Value)
  在上述語法基礎(chǔ)上去呐能，使用一個或多個鍵值對屬性參數(shù)來指定其他選項。常見屬性的鍵值對有：

'Format','default' | 'defaultdate' | 'preserveinput' | 字符向量 ：指定輸出數(shù)組中值的顯示格式抑堡。

Format 值	說明
'default'	使用默認的顯示格式
'defaultdate'	使用創(chuàng)建時無時間分量的日期時間值的默認顯示格式（即去掉時間分量）
'preserveinput'	使用輸入格式 infmt 指定的格式（若未指定 infmt摆出，則datetime 自動確認格式）
字符向量	使用字符向量指定的格式

'Locale',字符向量 ：DateStrings 輸入?yún)?shù)值的區(qū)域設置，Locale 值確定 datetime 如何解釋 DateStrings（但不決定如何顯示輸出 datetime 值）首妖。Locale 的常用可選值如下：

Locale 值	語言	國家/地區(qū)
'system'	系統(tǒng)區(qū)域設置	系統(tǒng)區(qū)域設置
'de_DE'	德語	德國
'en_GB'	英語	英國
'en_US'	英語	美國
'es_ES'	西班牙語	西班牙
'fr_FR'	法語	法國
'it_IT'	意大利語	意大利
'ja_JP'	日語	日本
'ko_KR'	韓語	韓國
'nl_NL'	荷蘭語	荷蘭
'zh_CN'	簡體中文	中國

'PivotYear',year(datetime('now'))-50（默認）| 整數(shù) ：指定雙字符年份所在的 100 年日期范圍的起始年份懊蒸，將年份指定為兩個字符的日期（僅當 infmt 參數(shù)包括 y 或 yy 時，起始年份才有效）悯搔。
【注】僅在使用 DateStrings 輸入?yún)?shù)時才能使用 'PivotYear' 鍵值對。

'TimeZone',''（默認）| 字符向量 ：指定時區(qū)（包括輸入數(shù)據(jù)和輸出數(shù)據(jù)）舌仍。如果輸入數(shù)據(jù)是包括時區(qū)的字符向量妒貌，則 datetime 函數(shù)將所有值轉(zhuǎn)換為指定的時區(qū)。TimeZone 的可選值有：

TimeZone 值	說明
''	用于創(chuàng)建不屬于特定時區(qū)的“未設定時區(qū)的” datetime 數(shù)組铸豁。
IANA 時區(qū)	時區(qū)地區(qū)的名稱根據(jù)在地理區(qū)域觀察到的情況灌曙，考慮了其標準時和夏令時與 UTC 之間的偏移量的當前和歷史規(guī)則
+HH:mm 或 -HH:mm	ISO 8601 字符向量，指定與 UTC 存在固定偏移量的時區(qū)
'UTC'	用于按協(xié)調(diào)時間時創(chuàng)建 datetime 數(shù)組
'UTCLeapSeconds'	用于按考慮閏秒的協(xié)調(diào)世界時創(chuàng)建 datetime 數(shù)組
'local'	用于按系統(tǒng)時區(qū)創(chuàng)建 datetime 數(shù)組（查詢 TimeZone 屬性是返回 IANA 值）

IANA 時區(qū)數(shù)據(jù)庫中常用時區(qū)地區(qū)的通用名稱如下：

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

2. datenum 函數(shù)

2.1 作用

datenum 函數(shù)用于將日期和時間轉(zhuǎn)換成日期序列值节芥，即將每個時間點表示為從 0000年 1月 0日起的天數(shù)在刺。

2.2 語法

DateNumber = datenum(t)
DateNumber = datenum(DateString)
DateNumber = datenum(DateString,formatIn)
DateNumber = datenum(DateString,PivotYear)
DateNumber = datenum(DateString,formatIn,PivotYear)
DateNumber = datenum(DateVector)
DateNumber = datenum(Y,M,D)
DateNumber = datenum(Y,M,D,H,MI,S)

• DateNumber = datenum(t)
  將 t （datetime 數(shù)組）中的日期時間值轉(zhuǎn)換為日期序列值（即從 0000年 1月 0日以來的天數(shù)及其小數(shù)值，采用前 ISO 日歷形式）头镊。

• DateNumber = datenum(DateString)
  將表示日期和時間的文本轉(zhuǎn)換為日期序列值（MatLab 自動搜索確認文本格式）蚣驼。

• DateNumber = datenum(DateString,formatIn)
  手動指定表示日期和時間的文本的格式為 formatIn（字符向量或字符串標量），加快 MatLab 的處理速度相艇。formatIn 的可取的文本格式如下表：

可用于構(gòu)造 formatIn 中的符號標識符可取值如下表：

• DateNumber = datenum(DateString,PivotYear)
  PivotYear（整數(shù)）指定雙字符年份所在的 100 年日期范圍內(nèi)的起始年份颖杏，其默認取值為 year(datetime('now'))-50 。
  【注】如果該語法下輸入日期格式指定四個字符的年份坛芽，則后兩個字符將被截斷留储，由前兩個字符指定年份。

• DateNumber = datenum(DateString,formatIn,PivotYear)
  結(jié)合以上兩種語法指定解析格式（formatIn 和 PivotYear 的順序任意）咙轩。

• DateNumber = datenum(DateVector)
  將日期向量解釋為日期序列值获讳，返回由 m 個日期序列值構(gòu)成的列向量。DateVectors 指定為 或 矩陣活喊，分別包含 個完全或部分日期向量丐膝。完整日期向量帶有六個元素，依順序分別指示年、月尤误、日侠畔、時、分损晤、秒软棺。部分日期向量指代有三個元素，依順序分別指示年尤勋、月喘落、日。DateVectors 的每個元素應為正整數(shù)或負整數(shù)值最冰，秒元素可以為小數(shù)瘦棋。如果某元素不在常規(guī)范圍之內(nèi)，則 datenum 會同時調(diào)整該日期向量元素及其前面的元素暖哨。

• DateNumber = datenum(Y,M,D)
  返回 Y赌朋、M、D（年篇裁、月沛慢、日）數(shù)組對應元素的日期序列值。Y达布、M团甲、D 數(shù)組的大小必須相同（或者其中任一數(shù)組可以為標量）。

• DateNumber = datenum(Y,M,D,H,MI,S)
  返回 Y黍聂、M躺苦、D、H产还、MI匹厘、S（年、月脐区、日集乔、時、分坡椒、秒）數(shù)組對應元素的日期序列值扰路。Y、M倔叼、D汗唱、H、MI丈攒、S 數(shù)組的大小必須相同（或者其中任一數(shù)組可以為標量）哩罪。

3. datevec 函數(shù)

3.1 作用

datevec 函數(shù)可以將日期和時間（datetime 格式授霸、datenum 格式或者文本格式）轉(zhuǎn)換為分量的向量。

3.2 語法

DateVector = datevec(t)
DateVector = datevec(DateNumber)
DateVector = datevec(DateString)
DateVector = datevec(DateString,formatIn)
DateVector = datevec(DateString,PivotYear)
DateVector = datevec(DateString,formatIn,PivotYear)
[Y,M,D,H,MI,S] = datevec(___)

• DateVector = datevec(t)
  將 datetime 數(shù)組 t 中的日期時間轉(zhuǎn)換為日期向量际插，返回一個 的矩陣碘耳，其中每行對應于 t 中的一個日期時間值。

• DateVector = datevec(DateNumber)
  將一個或多個日期數(shù)字轉(zhuǎn)換為日期向量框弛，返回一個包含 個日期向量的 矩陣（ 為 DateNumber 日期數(shù)字元素的個數(shù)）辛辨。DateNumber 可以為向量或矩陣，沿維度從 1 逐漸增大（比如二維矩陣先列后行）瑟枫，依次解釋對應的日期數(shù)值斗搞。

• DateVector = datevec(DateString)
  將表示日期或時間的文本轉(zhuǎn)換成日期向量（MatLab 自動搜索確認文本格式）。

• DateVector = datevec(DateString,formatIn)
  手動指定表示日期和時間的文本的格式為 formatIn（字符向量或字符串標量）慷妙，加快 MatLab 的處理速度僻焚。formatIn 的可取的文本格式如下表：

可用于構(gòu)造 formatIn 中的符號標識符可取值如下表：

• DateVector = datevec(DateString,PivotYear)
  PivotYear（整數(shù)）指定雙字符年份所在的 100 年日期范圍內(nèi)的起始年份，其默認取值為 year(datetime('now'))-50 膝擂。
  【注】如果該語法下輸入日期格式指定四個字符的年份虑啤，則后兩個字符將被截斷，由前兩個字符指定年份架馋。

• DateVector = datevec(DateString,formatIn,PivotYear)
  結(jié)合以上兩種語法指定解析格式（formatIn 和 PivotYear 的順序任意）咐旧。

• [Y,M,D,H,MI,S] = datevec(___)
  返回日期向量的分量到單獨的變量 Y、M绩蜻、D、H室埋、MI办绝、S（年、月姚淆、日孕蝉、時、分腌逢、秒）降淮。datevec 返回毫秒作為 S（秒）輸出的小數(shù)部分。

4. datestr 函數(shù)

4.1 作用

datestr 函數(shù)用于將日期和時間（datetime格式搏讶、datevec格式佳鳖、datenum格式）轉(zhuǎn)換為字符串格式。

4.2 語法

DateString = datestr(t)
DateString = datestr(DateVector)
DateString = datestr(DateNumber)
DateString = datestr(___,formatOut)
DateString = datestr(DateStringIn)
DateString = datestr(DateStringIn,formatOut)
DateString = datestr(DateStringIn,formatOut,PivotYear)
DateString = datestr(___,'local')

• DateString = datestr(t)
  將 datetime 數(shù)組 t 中的日期時間值轉(zhuǎn)換為日期和時間的文本（char媒惕、cellstr系吩、string 函數(shù)也可以將 datetime 值轉(zhuǎn)為文本）。返回包含 行的字符數(shù)組（ 是 t 中的日期時間值的總數(shù)）妒蔚。默認情況下穿挨，datestr 以 day-month-year hour:minute:second 格式返回文本月弛；若 hour:minute:second 為 00:00:00，則返回的文本格式為 day-month-year科盛。

• DateString = datestr(DateVector)
  將日期向量轉(zhuǎn)換為表示日期和時間的文本帽衙。datestr 返回包含 行的字符數(shù)組（ 是DateVector 中日期向量的總數(shù)）。

• DateString = datestr(DateNumber)
  將日期序列值轉(zhuǎn)換為表示日期和時間的文本贞绵，datestr 返回包含 行的字符數(shù)組（ 是 DateNumber 中的日期序列值的總數(shù)）厉萝。

• DateString = datestr(___,formatOut)
  在上述語法基礎(chǔ)上，使用 formatOut 指定輸出文本格式但壮。formatOut 的可取值為 -1（默認）| 字符向量 | 字符串向量 | 整數(shù) 冀泻。可用于構(gòu)造 formatOut 字符向量的符號標識符（可用連字符蜡饵、空格和冒號等字符來分割字段）如下：

【注】formatOut 字符向量必須遵循以下原則：

1. 每個字段（年弹渔、月、日溯祸、時肢专、分、秒）只能出現(xiàn)依次焦辅。
2. 當使用 AM 或 PM 字段時博杖，還需提供 HH 字段。
3. QQ 只能單獨使用或與年份標識符一起使用筷登。

formatOut 預定義日期格式如下表：

• DateString = datestr(DateStringIn)
  將 DateStringIn 轉(zhuǎn)換為 day-month-year hour:minute:second 格式的文本剃根。DateStringIn 表示的所有日期和時間必須具有相同的格式。

• DateString = datestr(DateStringIn,formatOut)
  在上一個語法的基礎(chǔ)上前方，以 formatOut 指定的格式將 DateStringIn 轉(zhuǎn)換為 DateString狈醉。DateStringIn 的格式應為下列格式之一：

• DateString = datestr(DateStringIn,formatOut,PivotYear)
  在上一個語法的基礎(chǔ)上，使用 PivotYear 解釋以雙字符形式指定年份的文本惠险。

• DateString = datestr(___,'local')
  在上述語法基礎(chǔ)上苗傅，返回以當前系統(tǒng)區(qū)域設置的語言表示的日期。如果參數(shù)列表中不包含 local班巩，則 datestr 以默認語言（美國英語）返回文本（local 參數(shù)必須在參數(shù)列表最后）渣慕。