主要内容

日历持续时间

以可变长度日历单位表示的时间长度

描述

中的值日历持续时间数组以可变长度的日历单位表示经过的时间。例如,一个月的天数取决于一年中的特定月份。使用日历持续时间的计算会考虑夏令时更改和闰年。使用日历持续时间数组可以简化涉及日历单位的日期时间数组的计算,例如像天和月一样。

创造

可以使用创建具有指定时间单位的日历持续时间数组花萼耳,CalQuarts,平静,calweeks卡戴斯功能。例如,要创建经过1、2和3个日历月的数组,请使用平静作用

M=平静月(1:3)
M=1×3日历持续时间数组1mo 2mo 3mo

您还可以使用创建日历持续时间数组日历持续时间函数,如下所述。

描述

实例

L=日历持续时间(Y、 医学博士)从数字数组创建日历持续时间数组Y,MD,分别含有数年,月份和天数。

L=日历持续时间(Y、M、D、,H、 米,S)还包括由指定的小时、分钟和秒H,医疗保险s分别地

实例

L=日历持续时间(Y、M、D、,T)从包含年、月和日数的数字数组以及持续时间数组中创建日历持续时间数组T包含经过的时间。

L=日历持续时间(X)从数字矩阵创建一系列日历持续时间。

实例

L=日历持续时间(___,“格式”,显示格式)另外指定显示格式作为总体安排性质L这个总体安排属性更改的显示L但不是它的价值。您可以将此语法与前面语法中的任何参数一起使用。

输入参数

全部展开

年、月和日,指定为数字数组。这些数组的大小必须相同,或者任何数组都可以是标量。Y、 医学博士必须仅包含整数值。

指定大于12的月份值等同于指定多年加上几个月。例如,25个月等于2年和1个月。但是,日本值不等同于多个月,因为一个月内的天数不是固定的,并且在将日历持续时间添加到特定日期时间之前,无法确定。

例子:L=日历持续时间(2,10,24)返回2年、10个月和24天的日历持续时间。

小时,分钟和秒,指定为数字阵列。这些阵列必须是相同的大小,或者任何可以是标量。指定分数秒作为一部分s这个H医疗保险数组只能包含整数值。

指定大于12的月值相当于指定年数加上月数。例如,25个月等于2年零1个月。大于60的分钟值会延续到若干小时。大于60的秒值将延续到数分钟。但是,日值不等于月数,因为月数不是固定的,只有将日历持续时间添加到特定日期时间后才能确定。类似地,小时值并不等同于日历天数。

例子:L=日历持续时间(2,10,24,12,45,07.451)返回2年、10个月、24天、12小时、45分钟和7.451秒的日历持续时间。

已用时间,指定为持续时间数组。T其中一个必须与另一个相同大小Y,MD输入参数或参数必须是标量。

例子:T =小时(5);L =日历(2,10,24,T)将5小时的持续时间添加到L.

年、月、日和可选时间,指定为数字矩阵。X必须有三列或六列。前三列分别包含年数、月数和日数。如果X有六列,然后最后三列分别包含小时数、分钟数和秒数。

除第六列外,所有列都必须包含整数值。您可以在第六列中指定小数秒。

例子:L=日历持续时间([2 10 24])返回2年、10个月和24天的日历持续时间。

例子:L=日历持续时间([2 10 24 12 45 07.451])返回2年、10个月、24天、12小时、45分钟和7.451秒的日历持续时间。

性质

全部展开

日历持续时间的显示格式,指定为字符组合Y,Q,M,W,DT,按那个顺序。格式必须包括M,DT.

性格 单元 必修的?
Y
Q 季度(3个月的倍数)
M
W
D
T 时间(小时、分钟和秒)

要指定小数秒显示的位数,请使用总体安排作用

如果日期或时间组件的值为零,则不显示。

例子:L.格式='yqmdt'显示中的每个值L作为日历年数、季度数、月数和天数及其时间组成。

例子

全部崩溃

创建日期时间值。

D=日期时间(2017,7,1)
D=日期时间2017年7月1日

创建一个datetime数组,其中每个值从不同月份的第一天开始。创建这样一个数组的一种方便方法是将日历月份数组添加到D.

首先,使用平静作用

C=平静月(0:3)
C=1x4日历持续时间0mo 1mo 2mo 3mo

然后,添加DC. 自从C是一个日历持续时间数组,此操作说明月份可以有不同的天数。

M=D+C
M=1x4日期时间2017年7月1日2017年8月1日2017年9月1日2017年10月1日

由于闰年和夏时制的原因,日历年、月和日的长度可以不同。要适应这些不同的时间长度,请使用日历持续时间数组对datetime数组进行算术运算。

L=日历持续时间(1,3,15)
L=日历持续时间1Y 3MO 15D

创建一个数字数组,表示天数。

D=[13;42]
D=2×21 3 4 2

创建以小时为单位表示运行时间的持续时间数组。一个元素指定25小时,这比一天长。

T=小时([12;25 12])
T=2x2持续时间1小时2小时25小时12小时

创建日历持续时间数组。指定输入参数D,T,以及年和月的标量值。第二个输入13指定的月份比一年中的月份多。

L=日历持续时间(1,13,D,T)
L=2x2日历持续时间2y 1mo 1d 1h 0m 0s 2y 1mo 3d 2h 0m 0s 2y 1mo 4d 25h 0m 0s 2y 1mo 2d 12h 0m 0s

大于12的月份值在显示屏中结转至年。但是,大于24的小时值不会在显示器中延续到天。由于夏时制,日历日的小时数不一定是24小时。

创建日历持续时间数组,并指定以月、周、日和时间为单位显示值的格式。

L=日历持续时间(1,1,5:9,“格式”,“mwdt”)
L=1x5日历持续时间13mo 5d 13mo 6d 13mo 1w 13mo 1w 1d 13mo 1w 2d

因为格式不包括“是的”对于年份,1年和1个月的输入值显示为它们的总和,13个月虽然“不”必须指定,如果小时、分钟和秒均为零,则不显示时间组件。

提示

  • 有关接受或返回日历持续时间数组的函数的详细信息,请参阅日期和时间.

  • 当您添加日历持续时间一个datetime中包含多个单元的数组,MATLAB®始终先添加更大的单位。如果T是日期时间,则此命令:

    t+日历持续时间(1,2,3)
    同:
    t+calyears(1)+平静月(2)+计算日(3)

扩展能力

在R2014B中介绍