Main Content

日期时间

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

日期时间数据类型 datetimedurationcalendarDuration 支持高效的日期时间计算、比较以及格式化显示方式。这些数组的处理方式与数值数组的处理方式相同。可以对日期时间值执行加法、减法、排序、比较、串联和绘图等操作。还可以将日期时间以数值数组或文本形式表示。有关详细信息,请参阅表示 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(不推荐;请改用 datetimeduration)将日期和时间转换为日期序列值
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将日期时间转换为分量向量
split将日历持续时间拆分为数值和持续时间单位
time将日历持续时间的时间转换为持续时间
timeofdaydatetime 数组中的值代表的自午夜以来经过的时间

datetime 数组

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

固定格式数组

addtodate(不推荐;请改用 durationcalendarDuration)为日期序列值增加时间
etime(不推荐;请改用 datetime 值或 between)日期向量之间经过的时间
months(Not recommended; use between) Number of whole months between dates
isbetween确定位于日期时间区间内的元素
isregular确定输入时间基于时间单位或日历单位是否规则
isnat确定 NaT(非时间)元素
isdst确定夏令时元素
isweekend确定周末元素
isdatetime确定输入是否为日期时间数组
isduration确定输入是否为持续时间数组
iscalendarduration确定输入是否为日历持续时间数组
string字符串数组
char字符数组
datestr(不推荐;请改用 stringchar)将日期和时间转换为字符串格式

转换

convertTodatetime 值转换为数值表示
exceltimeMATLAB 日期时间转换为 Excel 日期数字
posixtimeMATLAB 日期时间转换为 POSIX 时间
juliandateMATLAB 日期时间转换为儒略日期
yyyymmddMATLAB 日期时间转换为 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.convertDatenumConvert inputs to datetime values in a backward-compatible way (自 R2022a 起)

主题

疑难解答

日期向量和字符串结转

如果某元素不在常规范围内,则 MATLAB 会同时调整该日期向量元素及其前面的元素。

转换日期向量返回意外输出

由于日期向量是一个 1×6 数值向量,因此 datestr 可能会将您的输入日期向量解释为日期序列值向量(或将日期序列值解释为日期向量),并返回异常输出。