busdate

下一个或上一个工作日

全页折叠

语法

Busday = busdate(Date)
Busday = busdate(___,DirFlag,Holiday,Weekend)

说明

Busday = busdate(Date) 根据 Holiday 的定义返回下一个或上一个工作日的标量、向量或矩阵。

示例

Busday = busdate(___,DirFlag,Holiday,Weekend) 根据 Holiday 等可选输入参量返回下一个或上一个工作日的标量、向量或矩阵。

如果 Date 和 Holiday 都是字符串或日期字符向量，则 Busday 以序列日期值形式返回。使用 datetime 函数将序列日期值转换为格式化的日期时间数组。

但是，如果 Date 或 Holiday 是日期时间数组，则 Busday 以日期时间数组形式返回。

示例

示例

全部折叠

打开实时脚本

当 Date 指定为字符向量时，确定其下一个工作日。 

 Busday = busdate('3-Jul-2001', 1)
Busday = 
731037

datestr(Busday)
ans = 
'05-Jul-2001'

通过对 Weekend 参量进行相应设置来指示星期六为工作日。2003 年 7 月 4 日是星期五。使用 busdate 来验证 7 月 5 日星期六实际上是一个工作日。 

Weekend = [1 0 0 0 0 0 0];
Date = datestr(busdate('3-Jul-2003', 1, [], Weekend))
Date = 
'05-Jul-2003'

如果 Date 或 Holiday 是日期时间数组，则 Busday 以日期时间数组形式返回。 

Busday = busdate(datetime('3-Jul-2001','Locale','en_US'), 1)
Busday = datetime
   05-Jul-2001

此外，您还可以忽略节假日。

busdate(datetime(2022,11,23),1,NaT)
ans = datetime
   24-Nov-2022

输入参数

全部折叠

参考工作日，指定为使用日期时间数组、字符串数组或日期字符向量的标量、向量或矩阵。

为了支持现有代码，busdate 还接受将序列日期值作为输入，但不推荐使用它们。

数据类型: char | string | datetime

工作日计算惯例，指定为值为 follow、modifiedfollow、previous 或 modifiedprevious 的日期字符向量或日期字符向量元胞数组

此外，DirFlag 还可以是表示搜寻方向的标量、向量或矩阵，如果是寻找下一个工作日，则 DIREC = 1（默认值），如果是寻找上一个工作日，则 DIREC = -1。

数据类型: char | string

节假日和非交易日，指定为使用日期时间数组、字符串数组或日期字符向量的向量。

Holiday 中的所有日期都必须采用相同的格式：日期时间、字符串或日期字符向量。

注意

要绕过节假日和非交易日，请使用 NaT。例如， busdate(datetime(2022,11,23),1,NaT)。

为了支持现有代码，busdate 还接受将序列日期值作为输入，但不推荐使用它们。

数据类型: char | string | datetime

周末，指定为由 0 和 1 组成的长度为 7 的向量，其中 1 表示周末，此向量的第一个元素对应于星期日。

数据类型: double

输出参量

全部折叠

根据 Holiday 的定义，以标量、向量或矩阵形式返回的下一个或上一个工作日。

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

|

主题