Main Content

busdate

下一个或上一个工作日

说明

示例

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

示例

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

如果 DateHoliday 都是字符串或日期字符向量,则 Busday 以日期序列值形式返回。使用 datestr 函数将日期序列值转换为格式化的日期字符向量。

但是,如果 DateHoliday 是日期时间数组,则 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'

如果 DateHoliday 是日期时间数组,则 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

工作日计算惯例,指定为值为 followmodifiedfollowpreviousmodifiedprevious 的日期字符向量或日期字符向量元胞数组

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

数据类型: double | char | datetime

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

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

注意

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

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

数据类型: char | string | datetime

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

数据类型: double

输出参量

全部折叠

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

版本历史记录

在 R2006a 之前推出

全部展开