caldays

日历持续时间（以天为单位）

全页折叠

语法

D = caldays(X)

说明

caldays 函数返回表示日历日的数组。当您在日历计算中使用具有 calendarDuration 数据类型的数组时，计算会考虑闰年、夏令时变化和不同长度的日历月。要改为创建精确固定长度 24 小时制日期，请使用 days 函数。

D = caldays(X) 返回一个数组，表示等效于数组 X 中的值的日历天。

  • 如果 X 为数值数组，则 D 为 calendarDuration 数组，其中每个元素与 X 的对应元素中的日历天数相等。

  • 如果 X 为 calendarDuration 数组，则 D 为 double 数组，其中每个元素与 X 的对应元素中的整数日历天数相等。

示例

示例

全部折叠

打开实时脚本
X = magic(5);
D = caldays(X)
D = 5×5 calendarDuration
   17d   24d    1d    8d   15d
   23d    5d    7d   14d   16d
    4d    6d   13d   20d   22d
   10d   12d   19d   21d    3d
   11d   18d   25d    2d    9d
打开实时脚本

创建一个日历持续时间数组。然后，将每个值转换为等效的整数日历天数。

X = caldays(8:10) + hours(1.2345)
X = 1×3 calendarDuration
    8d 1h 14m 4.2s    9d 1h 14m 4.2s   10d 1h 14m 4.2s


D = caldays(X)
D = 1×3

     8     9    10

caldays 返回一个数值数组。

打开实时脚本

向当前日期和时间中添加两个日历天。

t = datetime('now') + caldays(2)
t = datetime
   15-Jul-2025 19:10:21
打开实时脚本

创建一个从 2014 年 3 月 18 日开始的连续日期序列。

T = datetime([2014,03,18]) + caldays(0:4)
T = 1×5 datetime
   18-Mar-2014   19-Mar-2014   20-Mar-2014   21-Mar-2014   22-Mar-2014

创建一个从 2014 年 3 月 18 日开始的日期序列，以 2 天为间隔。

T = datetime([2014,03,18]) + caldays(0:2:8)
T = 1×5 datetime
   18-Mar-2014   20-Mar-2014   22-Mar-2014   24-Mar-2014   26-Mar-2014

输入参数

全部折叠

输入数组，指定为数值数组、日历持续时间数组或逻辑数组。如果 X 是数值数组，则它必须仅包含整数值。即，您不能创建带小数的日历单位。

提示

  • 在用于日历计算中时，caldays 会考虑夏令时变化来创建日期。要创建精确固定长度（24 小时）的日期，请使用 days 函数。

扩展功能

全部展开

基于线程的环境
使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

在 R2014b 中推出

另请参阅

| |