Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

between

日历数学差分

说明

示例

dt = between(t1,t2) 返回 t1t2 中的日期时间值之间的差分。dt 输出是一个用日历分量年、月、日和时间表示的 calendarDuration 数组,满足 t2 = t1+dt

示例

dt = between(t1,t2,components) 根据指定的日历或时间分量返回日期时间值之间的差分。

示例

全部折叠

创建两个 datetime 数组。

t1 = datetime('now')
t1 = datetime
   30-Apr-2021 22:16:07

t2 = datetime('tomorrow','Format','dd-MMM-yyyy HH:mm:ss') + caldays(0:2)
t2 = 1x3 datetime
   01-May-2021 00:00:00   02-May-2021 00:00:00   03-May-2021 00:00:00

计算两个数组的差分。

dt = between(t1,t2)
dt = 1x3 calendarDuration
      1h 43m 52.104s   1d 1h 43m 52.104s   2d 1h 43m 52.104s

between 以天、小时、分钟和秒的形式返回一个包含差分的 calendarDuration 数组。

在 6 个月的时段内创建一个日期时间序列。然后,计算第一个日期与序列中的每个日期之间相差的天数。

t1 = datetime(2013,1,1);
t2 = dateshift(t1,'end','month',0:4)
t2 = 1x5 datetime
   31-Jan-2013   28-Feb-2013   31-Mar-2013   30-Apr-2013   31-May-2013

dt = between(t1,t2,'Days')
dt = 1x5 calendarDuration
    30d    58d    89d   119d   150d

输入参数

全部折叠

输入日期和时间,指定为 datetime 数组、字符向量、字符向量元胞数组或字符串数组。输入 t1t2 中必须至少有一个为 datetime 数组。t1t2 的大小必须相同,除非其中一个是标量。

输入日期和时间,指定为 datetime 数组、字符向量、字符向量元胞数组或字符串数组。输入 t1t2 中必须至少有一个为 datetime 数组。t1t2 的大小必须相同,除非其中一个是标量。

日历或时间分量,指定为下列字符向量之一,或包含其中一个或多个值的元胞数组或字符串数组:

  • 'years'

  • 'quarters'

  • 'months'

  • 'weeks'

  • 'days'

  • 'time'

'time' 之外,以上分量都是灵活的时间长度。例如,1 个月在添加到一月份的日期时间中时,和添加到二月份的日期时间中时,代表着不同的时间长度。

between 从最大的分量开始按降序作用于日历或时间分量。

通常,t2 不等于 t1 + dt,除非在 components 中包括 'time'

示例: {'years','quarters'}

数据类型: char | cell | string

输出参数

全部折叠

差分数组,以 calendarDuration 数组形式返回。

提示

  • 要以精确固定长度的持续时间计算 t1t2 中日期时间值的差分,请使用 t2-t1

扩展功能

在 R2014b 中推出