主要内容

持续时间

固定长度单位的时间长度

描述

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

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

创建

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

D =小时(1:3)
D = 1×3持续时间数组1 hr 2 hr 3 hr

属性创建持续时间数组持续时间函数,如下所述。

描述

例子

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

D = duration(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 =日期时间(“今天”
D =datetime2月26日—- 2022

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

方法创建一个小时数组小时函数。每个元素比前一个元素长两个小时。

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

然后,添加D而且H

T = d + h
T =1 x4 datetime第1 ~ 3列26-Feb-2022 00:00:00 26-Feb-2022 02:00:00 26-Feb-2022 04:00:00

使用持续时间数组对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 = duration(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 = duration(X,“格式”mm: ss的
D =3 x1持续时间123:16 65:59 105:

提示

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

扩展功能

版本历史

在R2014b中引入