主要内容

calendarDuration

单位长度变长时间的日历

扩展所有的页面

描述

中的值日历时间数组代表着日历时间可变长度的单位。例如,在一个月的天数取决于特定的一个月。计算与日历时间占夏令时变化和闰年。使用日历时间数组简化计算datetime数组,包括日历单位,如天,月。

datetime数据类型表示的时间点,而持续时间和calendarDuration使用固定长度的数据类型代表运行时间和日历时间单位,分别。

创建

您可以创建日历时间数组指定的时间单位使用calyears,calquarters,calmonths,calweeks,caldays功能。例如,要创建一个数组,运行时间的2和3个月内,使用calmonths函数。

M = calmonths (1:3)
M = 1×3 calendarDuration数组1 2 3莫莫莫

您还可以创建一个使用日历时间数组calendarDuration函数,下面描述。

语法

L = calendarDuration (Y, M, D)
L = calendarDuration (Y, M, D, H, S)
L = calendarDuration (Y, M, D, T)
L = calendarDuration (X)
L = calendarDuration (___、“格式”displayFormat)

描述

例子

L = calendarDuration (Y、M, D)创建一个数组的日历时间数字数组Y,米,D,包含许多年,月,日,分别。

L = calendarDuration (Y, M, D,H MI S)规定还包括小时、分钟和秒H,心肌梗死,年代,分别。

例子

L = calendarDuration (Y, M, D,T)创建一个数组的日历时间数值数组包含许多年,月,天,持续时间数组T包含运行时间。

L = calendarDuration (X)创建一个数组的日历时间数字矩阵。

例子

L = calendarDuration (___、“格式”displayFormat)另外指定displayFormat的价值格式的属性l。的格式属性更改显示的l但不是其价值观。你可以使用这个参数的语法与任何以前的语法。

输入参数

全部展开

年,月,日,指定为数字数组。这些数组的大小必须相同,或者任何可以是一个标量。Y、M, D必须只包含整数值。

指定值大于12月相当于指定几年加上几个月。例如,25个月等于2年1个月。然而,一天值并不等同于一个几个月,因为在一个月的天数是不固定的,不能确定,直到你添加日历时间到一个特定的datetime。

例子:L = calendarDuration (2、10、24)返回一个日历时间2年,10个月,24天。

小时、分钟和秒,指定为数字数组。这些数组的大小必须相同,或者任何可以是一个标量。指定分数秒的一部分年代。的H和心肌梗死数组必须只包含整数值。

指定值大于12月相当于指定几年加上几个月。例如,25个月等于2年1个月。分钟值大于60延续的小时数。第二个值大于60延续到数分钟。然而,一天值并不等同于一个几个月,因为在一个月的天数是不固定的,不能确定,直到您添加日历时间到一个特定的datetime。同样,不等同于小时值的日历天数。

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

运行时间,指定为一个数组。T要么必须是相同的大小Y,米,D输入参数或者是一个标量。

例子:T =小时(5);L = calendarDuration (T) 2, 10日,24日添加一个5小时的持续时间l。

年、月、日,并可选地,时间,指定为一个数字矩阵。X必须有三个或者6列。前三列包含许多年,月,分别和天。如果X有六列,最后三列包含的小时数,分和秒。

所有列必须包含整数值,除了第六列。您可以指定分数秒在第六列。

例子:L = calendarDuration (10 24 [2])返回一个日历时间2年,10个月,24天。

例子:L = calendarDuration ([2 10 24 12 45 07.451])返回一个日历时间2年,10个月,24天,12小时45分钟,7.451秒。

属性

全部展开

显示格式为日历时间,指定为字符的组合y,问,米,w,d,t,在这个秩序。格式必须包括米,d,t。

字符 单位 需要吗?
y 年 没有
问 季度(3个月)的倍数 没有
米 个月 是的
w 周 没有
d 天 是的
t 时间(小时、分钟和秒) 是的

指定数量的数字显示分数秒,使用格式函数。

如果一个日期或时间组件的值是零,那么它就是不显示。

例子:l格式= ' yqmdt '显示每个值在l随着日历年,季度,月和天,连同它的时间组件。

例子

全部折叠

打开生活的脚本

创建一个datetime值。

D = datetime (2017、7、1)
D =datetime01 - 7 - 2017

创建一个datetime数组中每一个值从一个月的第一天开始。数组创建这样一个方便的方法是添加一个日历月的数组D。

首先,创建一个日历月使用数组calmonths函数。

C = calmonths (0:3)
C =1 x4 calendarDuration0月1 2 3莫莫莫

然后,添加D和C。自C是一个日历时间数组,这个操作占个月可以有不同数量的天。

M = D + C
M =1 x4 datetime01 - 7月- 2017年1 - 8月- 2017年10月01 - 9月- 2017年01 - 2017

由于闰年和日光节约时间、日历年,月,日可以有不同的长度。适应这些不同长度的时间,使用日历时间数组为算术运算datetime数组。

打开生活的脚本 
L = calendarDuration (1、3、15)
L =calendarDuration1 y 3月15 d
打开生活的脚本

创建一个数字数组代表数量的天。

D = [1 3; 4 2]
D =2×21 2 3 4

创建一个数组表示持续时间在小时运行时间。一个元素指定了25个小时,超过一天。

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

创建一个数组日历时间。指定输入参数D,T年和月,标量值。第二个输入13指定比一年有几个月。

L = calendarDuration (1 13 D, T)
L =2 x2 calendarDuration2 y 1 mo 1 d 1 h 0 m 0 2 y 1 mo 3 d 2 h 0 m 0 2 y 1 mo 4 d 25 h 0 m 0 2 y 1 mo 2 d 12 h 0 m 0

月值大于12携带到年的显示。然而,值大于24小时不带显示到天。由于日光节约时间,在一个日历天的小时数并不一定是24小时。

打开生活的脚本

创建日历时间和指定数组的格式显示值的月,周,日,和时间。

L = calendarDuration (1, - 1, 9,“格式”,“mwdt”)
L =1 x5 calendarDuration13莫5 d 13莫6 d 13莫1 w 13莫1 w 1 d 13莫1 w 2 d

不包括自格式“y”多年来,1年,1月的输入值显示作为他们的总和,13个月。而“t”必须指定,如果显示的时间分量不小时,分钟,秒都是零。

提示

  • 有关函数的更多信息接受或返回日历时间数组,明白了日期和时间。

  • 当你添加一个calendarDuration数组,包含不止一个单元一个datetime, MATLAB®总是先说大单位。如果t是一个datetime,那么这个命令:

    t + calendarDuration (1、2、3)
    是一样的:
    t + calyears calmonths (1) + (2) + caldays (3)

扩展功能

版本历史

介绍了R2014b

另请参阅

|||||||||

主题