Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

datevec

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

说明

示例

注意

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

DateVector = datevec(t)datetimedurationt 转换为日期向量(即数值向量),其六个元素表示 t 的年、月、日、小时、分钟和秒分量。

如果 t 是具有 m 个元素的 datetimeduration 数组,则 datevec 返回一个 m×6 矩阵,其中每行对应于 t 中的一个值。

  • 如果 tdatetime 数组,则它的值表示时间点。DateVector 的每行都表示一个特定的日期时间。

  • 如果 tduration 数组,则它的值表示经过的时间。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 解析以两个字符指定年份的文本。可以按任一顺序指定 formatInPivotYear

示例

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

示例

全部折叠

format short g

t = [datetime('now');datetime('tomorrow')]
t = 2x1 datetime
   19-Aug-2023 14:25:11
   20-Aug-2023 00:00:00

DateVector = datevec(t)
DateVector = 2×6

         2023            8           19           14           25       11.174
         2023            8           20            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
103 ×

    2.0230    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

输入参数

全部折叠

日期时间,指定为 datetimeduration 值的数组。

数据类型: datetime | duration | calendarDuration

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

示例: '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,月份默认为一月,年份默认为当前年份。datevecdatenum 将双字符年份(例如 '79')视为处于以当前年份为中心的 100 年范围内。

如果不指定 formatIn,请注意以下内容:

  • 对于将月份指定为两位数 (mm) 的格式,月份值不得大于 12。

  • 但对于格式 'mm/dd/yy',如果文本中的第一个条目大于 12,第二个条目小于或等于 12,则 datevec 将文本视为采用 'yy/mm/dd' 格式。

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

示例: 'dddd, mmm dd, yyyy'

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

注意

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

符号标识符

描述

示例

yyyy

完整年份

1990, 2002

yy

两位数年份

90, 02

QQ

使用字母 Q 和一个数字的季度年份

Q1

mmmm

使用全名的月份

March, December

mmm

使用前三个字母的月份

Mar, Dec

mm

两位数月份

03, 12

m

使用大写首字母表示月份

M, D

dddd

使用全名的日期

Monday, Tuesday

ddd

使用前三个字母的日期

Mon, Tue

dd

两位数日期

05, 20

d

使用大写首字母表示日期

M, T

HH

两位数小时
(使用符号标识符 AMPM 时无前导零)

05, 5 AM

MM

两位数分钟

12, 02

SS

两位数秒

07, 59

FFF

三位数毫秒

057

AM or PM

在表示时间的文本中插入的 AMPM

3:45:02 PM

formatIn 值必须遵循以下原则:

  • 每个字段只能指定一次。例如,不能使用 'yy-mmm-dd-m',因为它有两个月份标识符。一种例外情况是,可以将一个 dd 实例与其他日期标识符的任何一个实例结合使用。例如,'dddd mmm dd yyyy' 是有效输入。

  • 当您使用 AMPM 时,还需要提供 HH 字段。

  • datevec 不接受包含 'QQ' 的格式

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

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

示例: 2000

注意

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

数据类型: double

输出参数

全部折叠

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

日期向量的分量(年、月、日、时、分、秒),以数值标量或数值向量形式返回。毫秒是秒输出的小数部分。在转换 datetime 数组 t 时,这些分量等于 YearMonthDayHourMinuteSecond 属性的值。例如,Y = t.Year

局限性

  • 如果第一个输入参数是 datetime 数组、数值数组或表示日期和时间的文本,则 datevec 会在输出中将小于 1 的任何月份值设置为 1。小于 1 的日期值 D 设置为上一个月最后一天的值减去 |D|。但是,如果 0 ≤ DateNumber < 1,则 datevec(DateNumber) 返回 [0 0 0 H MN S] 格式的日期向量,其中 HMNS 分别是时、分、秒。

  • 如果第一个输入参数是 duration 数组,则 datevec 的输出不表示时间点,而是表示以固定长度时间单位测量的时间长度。输出矩阵的每一行都将持续时间表示为年、月、日、小时、分钟和秒,其总和是由输入 duration 数组的对应元素表示的总时间长度。

    但是,月不能作为固定长度的时间单位,因为不同月份有不同天数。因此月数始终为零。在这种情况下,datevec 将持续时间表示为年数(每年 365.2425 天)、天数(每天 86400 秒)以及小时、分钟和秒数,其总和为该持续时间。由此产生的另一个结果是天数可能大于 31。

提示

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

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开