datevec

将日期和时间转换为分量向量

全页折叠

语法

DateVector = datevec(t)

DateVector = datevec(DateString)

DateVector = datevec(DateString,formatIn)

DateVector = datevec(DateString,PivotYear)

DateVector = datevec(DateString,formatIn,PivotYear)

[Y,M,D,H,MN,S] = datevec(___)

说明

注意

虽然您可以将日期和时间表示为日期向量，但建议您使用 datetime 值来表示时间点，使用 duration 或 calendarDuration 值来表示经过的时间。有关更新代码的详细信息，请参阅版本历史记录或Replace Discouraged Instances of Serial Date Numbers and Date Strings。

DateVector = datevec(t) 将输入数组转换为日期向量 - 即包含六个元素的数值行向量，这些元素分别表示输入日期和时间的年、月、日、时、分和秒分量。

如果输入数组 t 是具有 m 个元素的 datetime 或 duration 数组，则 datevec 返回一个 m×6 矩阵，其中每行对应于 t 中的一个值。

如果 t 是 datetime 数组，则它的值表示时间点。DateVector 的每行都表示一个特定的日期和时间。
如果 t 是 duration 数组，则它的值表示经过的时间。DateVector 的每行表示以固定长度时间单位测量的时间长度。因此，DateVector 的第二列中的值（表示月数）始终为零。有关详细信息，请参阅局限性。

示例

DateVector = datevec(DateString) 可将表示日期和时间的文本转换为日期向量。如果已知文本中使用的格式，则将格式指定为 formatIn。不含 formatIn 的语法的执行速度远远慢于包含此项的语法执行速度。

DateVector = datevec(DateString,formatIn) 使用 formatIn 解析 DateString 所表示的日期和时间。

示例

DateVector = datevec(DateString,PivotYear) 使用 PivotYear 解析以两个字符指定年份的文本。如果已知文本中使用的格式，则将格式指定为 formatIn。不含 formatIn 的语法的执行速度远远慢于包含此项的语法执行速度。

DateVector = datevec(DateString,formatIn,PivotYear) 使用 formatIn 解析 DateString 所表示的日期和时间，使用 PivotYear 解析以两个字符指定年份的文本。可以按任一顺序指定 formatIn 和 PivotYear。

示例

[Y,M,D,H,MN,S] = datevec(___) 返回日期向量的分量作为单独的变量 Y、M、D、H、MN 和 S（分别代表年、月、日、时、分和秒）。datevec 函数返回毫秒作为秒 (S) 输出的小数部分。

示例

全部折叠

将日期时间数组转换为日期向量

打开实时脚本

format short g

t = [datetime('now');datetime('tomorrow')]

t = 2×1 datetime
   13-Jul-2025 18:34:03
   14-Jul-2025 00:00:00

DateVector = datevec(t)

DateVector = 2×6

         2025            7           13           18           34        3.974
         2025            7           14            0            0            0

将表示日期的文本转换为日期向量

打开实时脚本

DateString = '28.03.2005';
formatIn = 'dd.mm.yyyy';
datevec(DateString,formatIn)

ans = 1×6

        2005           3          28           0           0           0

对于表示日期的文本，datevec 将返回一个日期向量，其格式为 'dd.mm.yyyy'。

将多个日期字符串转换为日期向量

打开实时脚本

将多个日期作为元胞数组中的字符向量进行传递。所有输入日期必须使用相同的格式。

DateString = {'09/16/2007';'05/14/1996';'11/29/2010'};
formatIn = 'mm/dd/yyyy';
datevec(DateString,formatIn)

ans = 3×6

        2007           9          16           0           0           0
        1996           5          14           0           0           0
        2010          11          29           0           0           0

将带有毫秒的日期转换为日期向量

打开实时脚本

datevec('11:21:02.647','HH:MM:SS.FFF')

ans = 1×6
10³ ×

    2.0250    0.0010    0.0010    0.0110    0.0210    0.0026

在输出日期向量中，毫秒作为秒字段的小数部分。文本 '11:21:02.647' 包含的信息不足，无法转换成完整的日期向量。日期将默认为 1 日，月份将默认为 1 月，年份将默认为当前月份。

使用基准年份将日期字符串转换为日期向量

打开实时脚本

使用默认基准年份将表示日期的文本转换为日期向量。

DateString = '12-jun-17';
formatIn = 'dd-mmm-yy';
DateVector = datevec(DateString,formatIn)

DateVector = 1×6

        2017           6          12           0           0           0

使用 1800 作为基准年份，将同一日期转换为日期向量。

DateVector = datevec(DateString,formatIn,1800)

DateVector = 1×6

        1817           6          12           0           0           0

针对返回的日期向量分配元素

打开实时脚本

将表示日期的文本转换为日期向量，并返回该日期向量的分量。

[y, m, d, h, mn, s] = datevec('01.02.12','dd.mm.yy')

y = 
2012

m = 
2

d = 
1

h = 
0

mn = 
0

s = 
0

输入参数

全部折叠

`t` — 日期和时间
`datetime` 或 `duration` 值的数组

日期和时间，指定为 datetime 或 duration 值的数组。

如果 t 的任一元素是 NaT 或 NaN，则 datevec 返回的对应日期向量是一个由 NaN 组成的 6 元素行向量。

数据类型: datetime | duration | calendarDuration

`DateString` — 表示日期和时间的文本
字符数组 | 字符向量元胞向量 | 字符串向量

表示日期和时间的文本，指定为字符数组（每一行包含表示一个时间点的文本）、字符向量元胞向量或字符串向量。一个字符数组中的所有行，或者一个元胞向量或字符串向量中的所有元素，必须具有相同的格式。

示例: '24-Oct-2003 12:45:07'

示例: ['19-Sep-2013';'20-Sep-2013';'21-Sep-2013']

示例: {'15-Oct-2010' '20-Nov-2012'}

如果已知文本中使用的格式，也应指定 formatIn。如果您不指定 formatIn，则 DateString 必须为以下格式之一。

表示日期和时间的文本的格式	示例
`'dd-mmm-yyyy HH:MM:SS'`	`01-Mar-2000 15:45:17`
`'dd-mmm-yyyy'`	`01-Mar-2000`
`'mm/dd/yyyy'`	`03/01/2000`
`'mm/dd/yy'`	`03/01/00`
`'mm/dd'`	`03/01`
`'mmm.dd,yyyy HH:MM:SS'`	`Mar.01,2000 15:45:17`
`'mmm.dd,yyyy'`	`Mar.01,2000`
`'yyyy-mm-dd HH:MM:SS'`	`2000-03-01 15:45:17`
`'yyyy-mm-dd'`	`2000-03-01`
`'yyyy/mm/dd'`	`2000/03/01`
`'HH:MM:SS'`	`15:45:17`
`'HH:MM:SS PM'`	`3:45:17 PM`
`'HH:MM'`	`15:45`
`'HH:MM PM'`	`3:45 PM`

注意

描述日期和时间格式的符号标识符不同于描述 datetime 数组的显示格式的符号标识符。

某些格式可能未包含足够的信息，无法转换日期和时间的文本表示形式。在这些情况下，小时、分钟和秒默认为 0，天默认为 1，月份默认为一月，年份默认为当前年份。datevec 和 datenum 将双字符年份（例如 '79'）视为处于以当前年份为中心的 100 年范围内。

如果不指定 formatIn，请注意以下内容：

对于将月份指定为两位数 (mm) 的格式，月份值不得大于 12。
但对于格式 'mm/dd/yy'，如果文本中的第一个条目大于 12，第二个条目小于或等于 12，则 datevec 将文本视为采用 'yy/mm/dd' 格式。

`formatIn` — 表示日期和时间的输入文本的格式
字符向量 | 字符串标量

表示日期和时间的输入文本的格式，指定为由符号标识符组成的字符向量或字符串标量。

示例: 'dddd, mmm dd, yyyy'

下表显示了可用于构造 formatIn 字符向量的符号标识符。可以使用连字符、空格或冒号等字符来分隔字段。

注意

描述日期和时间格式的符号标识符不同于描述 datetime 数组的显示格式的标识符。

符号标识符	描述	示例
`yyyy`	完整年份	`1990`, `2002`
`yy`	两位数年份	`90`, `02`
`QQ`	使用字母 `Q` 和一个数字的季度年份	`Q1`
`mmmm`	使用全名的月份	`March`, `December`
`mmm`	使用前三个字母的月份	`Mar`, `Dec`
`mm`	一位数或两位数的月份	`3`, `06`, `12`
`m`	使用大写首字母表示月份	`M`, `D`
`dddd`	使用全名的日期	`Monday`, `Tuesday`
`ddd`	使用前三个字母的日期	`Mon`, `Tue`
`dd`	一位数或两位数的日期	`5`, `09`, `20`
`d`	使用大写首字母表示日期	`M`, `T`
`HH`	两位数小时（使用符号标识符 `AM` 或 `PM` 时无前导零）	`05`, `5` `AM`
`MM`	两位数分钟	`12`, `02`
`SS`	两位数秒	`07`, `59`
`FFF`	三位数毫秒	`057`
`AM or PM`	在表示时间的文本中插入的 `AM` 或 `PM`	`3:45:02` `PM`

formatIn 值必须遵循以下原则：

每个字段只能指定一次。例如，不能使用 'yy-mmm-dd-m'，因为它有两个月份标识符。一种例外情况是，可以将一个 dd 实例与其他日期标识符的任何一个实例结合使用。例如，'dddd mmm dd yyyy' 是有效输入。
当您使用 AM 或 PM 时，还需要提供 HH 字段。
datevec 不接受包含 'QQ' 的格式

`PivotYear` — 100 年日期范围的起始年份
现在减去 50 年 (默认) | 整数

双字符年份所在的 100 年日期范围的起始年份，指定为整数。使用基准年份来解释将年份指定为两个字符的日期。

如果 formatIn 包含一天中的时间，则将根据当前日期、月份和年份的当前时间来计算基准年份。否则，将根据当前日期、月份和年份的午夜来进行计算。

示例: 2000

注意

如果输入日期格式指定四个字符的年份，则后两个字符将被截断，由前两个字符指定年份。例如，如果日期和基准年份指定为 ('25122015','ddmmyyyy',2000)，则生成的日期为 25-12-2020，而不是 25-12-2015。

数据类型: double

输出参量

全部折叠

`DateVector` — 日期向量
向量 | 矩阵

日期向量，以 m×6 矩阵形式返回，其中每行对应一个日期向量，m 是输入日期数字或表示日期和时间的字符向量的总数。

如果输入是 datetime 或 duration 数组，且任一元素是 NaT 或 NaN，则 datevec 返回的对应日期向量是一个由 NaN 组成的 6 元素行向量。

`[Y,M,D,H,MN,S]` — 日期向量的分量
数值标量 | 数值向量

日期向量的分量（年、月、日、时、分、秒），以数值标量或数值向量形式返回。毫秒是秒输出的小数部分。在转换 datetime 数组 t 时，这些分量等于 Year、Month、Day、Hour、Minute 和 Second 属性的值。例如，Y = t.Year。

局限性

如果第一个输入参量是 datetime 数组、数值数组或表示日期和时间的文本，则 datevec 会在输出中将小于 1 的任何月份值设置为 1。小于 1 的日期值 D 设置为上一个月最后一天的值减去 |D|。但是，如果 0 ≤ DateNumber < 1，则 datevec(DateNumber) 返回 [0 0 0 H MN S] 格式的日期向量，其中 H、MN 和 S 分别是时、分、秒。
如果第一个输入参量是 duration 数组，则 datevec 的输出不表示时间点，而是表示以固定长度时间单位测量的时间长度。输出矩阵的每一行都将持续时间表示为年、月、日、小时、分钟和秒，其总和是由输入 duration 数组的对应元素表示的总时间长度。
但是，月不能作为固定长度的时间单位，因为不同月份有不同天数。因此月数始终为零。在这种情况下，datevec 将持续时间表示为年数（每年 365.2425 天）、天数（每天 86400 秒）以及小时、分钟和秒数，其总和为该持续时间。由此产生的另一个结果是天数可能大于 31。

提示

向量化调用语法可以为大型数组提供显著的性能改进。

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

datevec 函数支持 tall 数组，但存在以下使用说明和限制：

第一个参量必须为列向量、字符向量或字符数组。

有关详细信息，请参阅 tall 数组。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

从 R2020b 开始，在生成的代码中，此函数仅支持 datetime 和 duration 数组作为输入。您不能在生成的代码中指定序列日期值或文本作为输入。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

用法说明和限制：

仅支持以下语法：
DateVector = datevec(t)
[Y,M,D,H,MN,S] = datevec(t)

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 不推荐使用序列日期值

不推荐以序列日期值作为输入调用 datevec。请改用 datetime 数据类型来表示时间点。datetime 数据类型提供灵活的日期和时间格式、纳秒精度的存储，以及考虑时区和夏令时的属性。

要将 datetime 值拆分为日期和时间分量，请使用 hms、ymd 或 datevec 函数，或使用 datetime 值的 Year、Month、Day、Hour、Minute 和 Second 属性。

例如，对表示当前日期和时间的 datetime 值调用 datevec。

d = datetime("now")

d = datetime
   15-Apr-2022 15:53:28

format shortg
dateVector = datevec(d)

dateVector =

        2022           4          15          15          53          28

要访问一个分量，请使用对应的 datetime 属性。例如，获取 d 的 Month 属性的值。

monthValue = d.Month

monthValue =

     4

另请参阅

datevec

语法

说明

示例

将日期时间数组转换为日期向量

将表示日期的文本转换为日期向量

将多个日期字符串转换为日期向量

将带有毫秒的日期转换为日期向量

使用基准年份将日期字符串转换为日期向量

针对返回的日期向量分配元素

输入参数

t — 日期和时间 datetime 或 duration 值的数组

DateString — 表示日期和时间的文本 字符数组 | 字符向量元胞向量 | 字符串向量

formatIn — 表示日期和时间的输入文本的格式 字符向量 | 字符串标量

PivotYear — 100 年日期范围的起始年份 现在减去 50 年 (默认) | 整数

输出参量

DateVector — 日期向量 向量 | 矩阵

[Y,M,D,H,MN,S] — 日期向量的分量 数值标量 | 数值向量

局限性

提示

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2022b: 不推荐使用序列日期值

另请参阅

主题

`t` — 日期和时间
`datetime` 或 `duration` 值的数组

`DateString` — 表示日期和时间的文本
字符数组 | 字符向量元胞向量 | 字符串向量

`formatIn` — 表示日期和时间的输入文本的格式
字符向量 | 字符串标量

`PivotYear` — 100 年日期范围的起始年份
现在减去 50 年 (默认) | 整数

`DateVector` — 日期向量
向量 | 矩阵

`[Y,M,D,H,MN,S]` — 日期向量的分量
数值标量 | 数值向量

tall 数组
对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。