主要内容

持续时间

以固定长度为单位的时间长度

描述

a中的值持续时间数组以固定长度(如小时、分钟和秒)为单位表示经过的时间。您还可以创建固定长度(24小时)天和固定长度(365.2425天)年的运行时间。

使用持续时间数组就像使用数字数组一样。您可以添加、减去、排序、比较、连接和绘制持续时间数组。使用持续时间数组可以简化涉及小时和分钟等时间单位的datetime数组的计算。

创建

属性可以创建具有指定时间单元的持续时间数组小时分钟,毫秒功能。例如,要创建一个运行时间为1、2和3小时的数组,使用小时函数。

D =小时(1:3)
D = 1×3 duration array 1 hr 2 hr 3 hr

属性也可以创建持续时间数组持续时间函数,下面描述。

描述

例子

D =时间(H MI S由指定的小时、分钟和秒数的数字数组创建持续时间数组H心肌梗死,年代

D =时间(H MI S女士将毫秒添加到持续时间数组,由女士

例子

D =时间(X从数字矩阵创建持续时间的列向量。

例子

D =时间(TimeStrings将表示流逝时间的文本转换为持续时间数组。TimeStrings必须使用“hh: mm: ss”或者是“弟弟:hh: mm: ss”格式。

例子

D =时间(TimeStringsInputFormat”,infmt使用指定的格式转换文本infmt

例子

D =时间(___、“格式”displayFormat)另外指定的显示格式D.的显示D,而不是它的价值。您可以将此语法与前面语法中的任何参数一起使用。

输入参数

全部展开

指定为数字数组的小时、分钟和第二个数组。这些数组中的任何一个都可以是标量。所有非标量的数组必须具有相同的大小。

例子:持续时间(12,45岁,7)返回持续时间为12小时45分钟7秒。

毫秒数组,指定为数字数组。女士必须是一个标量或与H心肌梗死,年代输入参数。

例子:持续时间(12,45岁,30岁,35)返回12小时、45分钟、30秒和35毫秒的持续时间。

输入矩阵,指定为数字矩阵。X必须有三列,分别包含小时、分钟和秒。

例子:时间([12 30 16])返回持续时间为12小时、30分钟和16秒。

表示运行时间的文本,指定为字符向量、字符向量单元格数组或字符串数组。的持续时间函数尝试匹配的格式TimeStrings来的“hh: mm: ss”“弟弟:hh: mm: ss”格式,ddhh毫米,党卫军表示天、小时、分和秒。最后一个字段可以包括代表小数秒的小数点右边的数字。

如果您知道格式,请指定“InputFormat”与其相应的infmt价值。

例子:持续时间(“12:30:16”)返回持续时间为12小时、30分钟和16秒。

例子:持续时间(“00:05:23.86”)返回持续时间为5分23.86秒。

例子:时间({‘01:34:21’;‘23:16:54})返回包含两个持续时间的列向量。

输入文本的格式,指定为字符向量或字符串标量。

指定infmt作为下列任何一种格式,其中ddhh毫米,党卫军表示天、小时、分和秒:

  • “弟弟:hh: mm: ss”

  • “hh: mm: ss”

  • mm: ss的

  • “hh: mm”

  • 前三种格式中的任何一种,最多九种年代表示小数位数的字符,例如“hh: mm: ss。瑞士的

属性

全部展开

显示格式,指定为字符向量或字符串标量。这种格式可以指定带有时间单位的单个数字(例如“y”或数字计时器(如“hh: mm: ss”以小时、分钟和秒为单位)。

对于带有时间单位的数字,请指定以下任意一个:

  • “y”-固定长度的年,一年等于365.2425天

  • ' d '-固定长度的一天,一天等于24小时

  • “h”- - - - - -小时

  • “米”- - - - - -分钟

  • “年代”- - - - - -秒

对于数字定时器格式,指定以下格式之一:

  • “弟弟:hh: mm: ss”

  • “hh: mm: ss”

  • mm: ss的

  • “hh: mm”

  • 前三种格式中的任何一种,最多九种年代表示小数位数的字符,例如“hh: mm: ss。瑞士的

例子:D.Format = ' m '显示D以分钟为单位。

例子

全部折叠

创建一个datetime值。

D = datetime (“今天”
D =datetime01 - 9 - 2021

创建一个datetime数组,其中每个值具有相同的日期但不同的时间组件。创建这样一个数组的一种方便的方法是添加一个持续时间数组D

首先,使用小时函数。每个元素比前一个元素长两个小时。

H =小时(0:2:6)
H =1 x4持续时间0小时2小时4小时6小时

然后,添加DH

T = d + h
T =1 x4 datetimeColumn 1 to 3 01-Sep-2021 00:00:00 01-Sep-2021

使用持续时间数组对datetime数组和固定时间长度进行算术操作。

创建一个持续时间数组,指定小时、分钟和秒作为输入参数。由于第二个参数是一个数组,输出D是具有相同大小的数组。

D =持续时间(1 30:33 0)
D =1 x4持续时间01:30:00 01:31:00 01:32:00 01:33:00

创建一个有三列的数字矩阵。这些列分别表示小时、分钟和秒。

X = [12 17 54;9 32 3]
X =2×312 17 54 9 32 3

将矩阵转换为持续时间数组。

D =持续时间(X)
D =2 x1持续时间12:17:54 09:32:03

将表示时间的字符向量转换为小时、分钟和秒。

T =“6:34:12”;D =持续时间(T)
D =持续时间06:34:12

转换字符向量的单元格数组。

T = {“12:54:37”“8:03:12”};D =持续时间(T)
D =1 x2持续时间12:54:37 08:03:12

转换文本,也有一天的组件。对于显示,持续时间数组的默认格式将天数转换为小时。

T =“1:00:54:21”;D =持续时间(T)
D =持续时间24:54:21

指定表示运行时间的文本格式,然后将它们转换为持续时间数组。

转换字符向量。输入格式表示分和秒。输出参数是一个持续时间值,其格式表示小时、分钟和秒。

T =“78:34”;infmt =mm: ss的;D =时间(T)“InputFormat”infmt)
D =持续时间01:18:34

创建字符向量的单元格数组,其格式表示分钟、秒和从一秒到小数点后三位的小数部分。

infmt =mm: ss。瑞士的;T = {“1:34.862”“67:07.218”
T =1 x2单元格{' 1:34.862} {' 67:07.218 '}

转换T到持续时间数组。指定持续时间数组的格式表示小时、分钟、秒和几分之一秒。

outfmt =“hh: mm: ss。瑞士的;D =时间(T)“InputFormat”infmt,“格式”outfmt)
D =1 x2持续时间00:01:34.862 01:07:07.218

从一个矩阵创建一个持续时间数组。这三列分别指定小时、分钟和秒。显示数字定时器格式的值显示分钟和秒。

X = [2 3 16;1 5 59;1 45 0]
X =3×32 3 16 1 5 59 1 45 0
D =持续时间(X,“格式”mm: ss的
D =3 x1持续时间123:16 65:59 105:00

提示

  • 有关接受或返回持续时间数组的函数的更多信息,请参见日期和时间

扩展功能

介绍了R2014b