between

日历数学差分

全页折叠

语法

dt = between(t1,t2)
dt = between(t1,t2,components)

说明

between 函数返回两个日期时间数组之间的日历差分。当 between 计算两个日期时间值之间的日历差分时，它会考虑闰年、夏令时变化以及日历月的不同长度。要将差分计算为精确的固定长度持续时间，请改为使用减法，如 dt = t2 - t1。

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

示例

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

示例

示例

全部折叠

打开实时脚本

创建两个 datetime 数组。

t1 = datetime('now')
t1 = datetime
   13-Jul-2025 19:28:48


t2 = datetime('tomorrow','Format','dd-MMM-yyyy HH:mm:ss') + caldays(0:2)
t2 = 1×3 datetime
   14-Jul-2025 00:00:00   15-Jul-2025 00:00:00   16-Jul-2025 00:00:00

计算两个数组的差分。

dt = between(t1,t2)
dt = 1×3 calendarDuration
      4h 31m 11.036s   1d 4h 31m 11.036s   2d 4h 31m 11.036s

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

打开实时脚本

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

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


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

输入参数

全部折叠

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

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

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

  • 'years'

  • 'quarters'

  • 'months'

  • 'weeks'

  • 'days'

  • 'time'

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

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

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

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

数据类型: char | cell | string

输出参量

全部折叠

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

提示

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

扩展功能

全部展开

版本历史记录

在 R2014b 中推出

另请参阅

| | |