日期时间

可使用不同格式显示的日期时间值数组

日期时间数据类型 datetime、duration 和 calendarDuration 支持高效的日期时间计算、比较以及格式化显示方式。这些数组的处理方式与数值数组的处理方式相同。可以对日期时间值执行加法、减法、排序、比较、串联和绘图等操作。还可以将日期时间以数值数组或文本形式表示。有关详细信息，请参阅表示 MATLAB 中的日期时间或观看日期时间数组。

函数

全部展开

创建日期时间数组

时间点

`datetime`	表示时间点的数组
`dateshift`	推移日期或生成日期与时间序列
`NaT`	非时间 (Not-a-Time)
`eomday`	一个月中的最后一天
`lweekdate`	(Not recommended; use `dateshift`) Date of last occurrence of weekday in month
`nweekdate`	(Not recommended; use `dateshift`) Date of specific occurrence of weekday in month

持续时间

`years`	持续时间（以年为单位）
`days`	持续时间，以天为单位
`hours`	持续时间（以小时为单位）
`minutes`	以分钟为单位的持续时间
`seconds`	以秒为单位的持续时间
`milliseconds`	以毫秒为单位的持续时间
`duration`	固定长度单位的时间长度

日历持续时间

`calyears`	日历持续时间（以年为单位）
`calquarters`	日历持续时间（以季度为单位）
`calmonths`	日历持续时间（以月为单位）
`calweeks`	日历持续时间（以周为单位）
`caldays`	日历持续时间（以天为单位）
`calendarDuration`	以可变长度日历单位表示的时间长度

月历

calendar 指定的月份的日

替代格式的时间点

`datenum`	(Not recommended; use `datetime` or `duration`) Convert date and time to serial date number
`now`	（不推荐；请改用 `datetime`）当前日期时间作为日期序列值
`clock`	（不推荐；请改用 `datetime`）日期向量形式的当前日期时间
`date`	（不推荐；请改用 `datetime("today")`）当前日期作为字符向量
`today`	（不推荐；请改用 `datetime("today")`）当前日期
`eomdate`	(Not recommended; use `dateshift`) Last date of month

日期时间分量

提取分量

`year`	日期时间输入的年份值
`quarter`	日期时间输入的季度值
`month`	日期时间输入的月份值或名称
`week`	日期时间输入的周数值
`day`	日期时间输入的日期值或日期名称
`weekday`	星期几
`hour`	日期时间输入的小时分量
`minute`	日期时间输入的分钟分量
`second`	日期时间输入的秒分量
`weeknum`	(Not recommended; use `week`) Week in year

拆分为分量

`ymd`	日期时间的年、月和日数字
`hms`	日期时间或持续时间的小时、分钟和秒数
`datevec`	Convert date and time to vector of components
`split`	将日历持续时间拆分为数值和持续时间单位
`time`	将日历持续时间的时间转换为持续时间
`timeofday`	`datetime` 数组中的值代表的自午夜以来经过的时间

计算差异或推移日期

`datetime` 数组

`between`	日历数学差分
`caldiff`	日历数学连续差分
`tzoffset`	相对于 UTC 的时区偏移量
`dateshift`	推移日期或生成日期与时间序列

固定格式数组

`addtodate`	（不推荐；请改用 `duration` 或 `calendarDuration`）为日期序列值增加时间
`etime`	（不推荐；请改用 `datetime` 值或 `between`）日期向量之间经过的时间
`months`	(Not recommended; use `between`) Number of whole months between dates

查询数组内容

`isbetween`	Determine which elements are within specified range
`isregular`	确定输入时间基于时间单位或日历单位是否规则
`isnat`	确定 NaT（非时间）元素
`isdst`	确定夏令时元素
`isweekend`	确定周末元素
`isdatetime`	确定输入是否为日期时间数组
`isduration`	确定输入是否为持续时间数组
`iscalendarduration`	确定输入是否为日历持续时间数组

转换为文本

`string`	字符串数组
`char`	字符数组
`datestr`	(Not recommended; use `string` or `char`) Convert date and time to string format

Excel、POSIX 及其他日期时间系统

转换

`convertTo`	将 `datetime` 值转换为数值表示
`exceltime`	将 MATLAB 日期时间转换为 Excel 日期数字
`posixtime`	将 MATLAB 日期时间转换为 POSIX 时间
`juliandate`	将 MATLAB 日期时间转换为儒略日期
`yyyymmdd`	将 MATLAB 日期时间转换为 YYYYMMDD 数值
`m2xdate`	(Not recommended; use `exceltime`) MATLAB date to Excel serial date number
`x2mdate`	(Not recommended; use `datetime`) Excel serial date number to MATLAB serial date number or `datetime` value

MATLAB 中的时间

`timezones`	列出时区
`leapseconds`	列出 `datetime` 数据类型支持的所有闰秒 (自 R2020a 起)

向后兼容性

matlab.datetime.compatibility.convertDatenum Convert inputs to datetime values in a backward-compatible way (自 R2022a 起)

主题

表示 MATLAB 中的日期时间

使用 datetime 数组来存储日期时间信息。这些数组支持算术运算、排序、比较、绘图和格式化显示。
Replace Discouraged Instances of Serial Date Numbers and Date Strings
As of R2022b, serial date numbers and date strings are not recommended for specifying dates and times. Use the datetime, duration, and calendarDuration data types instead. Follow these recommendations for updating your code.
比较日期时间

使用关系运算符比较日期、时间和持续时间，如 >、< 和 ==，同时考虑时区和夏令时。
- 日期时间算术运算
- 绘制日期时间
设置日期时间显示格式
datetime、duration 和 calendarDuration 数组的 Format 属性用于控制每个数组中的值的显示方式。您可以更改此属性的值。更改 Format 属性并不会更改数组中的值，它只会更改其显示方式。
指定时区

为 datetime 数组指定时区，以考虑时区偏移量、夏令时或闰秒。
- 将日期时间转换为儒略日期或 POSIX 时间
在不同区域设置之间共享代码和数据
与其他区域设置中的 MATLAB^® 用户共享用于处理日期时间的代码时，请遵循以下最佳做法。写入和读取其他区域设置中的日期。
支持日期时间数组的核心函数
MATLAB 中的许多函数在处理日期时间数组时与处理其他数组并无不同。