金融日期与图表处理函数详解

### 金融日期与图表处理函数详解 在金融数据分析和处理中，准确处理日期和可视化数据是非常重要的。本文将详细介绍几个常用的金融函数，包括`busdate`、`busdays`、`candle`、`candle (fts)`和`cdai`，帮助你更好地进行金融数据处理和分析。 #### 1. `busdate`：计算下一个或上一个工作日 `busdate`函数用于根据给定的日期计算下一个或上一个工作日。 ##### 1.1 语法 ```matlab Busday = busdate(Date) Busday = busdate( ___ ,DirFlag,Holiday,Weekend) ``` ##### 1.2 描述 - `busdate(Date)`：根据`Holiday`的定义，返回下一个或上一个工作日的标量、向量或矩阵。 - `busdate( ___ ,DirFlag,Holiday,Weekend)`：根据可选输入参数（包括`Holiday`），返回下一个或上一个工作日的标量、向量或矩阵。 如果`Date`和`Holiday`都是字符串或日期字符向量，则`Busday`以序列日期数的形式返回。可以使用`datestr`函数将序列日期数转换为格式化的日期字符向量。如果`Date`或`Holiday`是`datetime`数组，则`Busday`以`datetime`数组的形式返回。 ##### 1.3 示例 ```matlab % 确定当Date为字符向量时的下一个工作日 Busday = busdate('3-Jul-2001', 1) Busday = 731037 datestr(Busday) ans = '05-Jul-2001' % 指示周六为工作日 Weekend = [1 0 0 0 0 0 0]; Date = datestr(busdate('3-Jul-2003', 1, [], Weekend)) Date = '05-Jul-2003' % 如果Date或Holiday是datetime数组，Busday以datetime数组的形式返回 Busday = busdate(datetime('3-Jul-2001','Locale','en_US'), 1) Busday = datetime 05-Jul-2001 ``` ##### 1.4 输入参数 | 参数 | 描述 | 数据类型 | | ---- | ---- | ---- | | `Date` | 参考工作日日期，可以是`datetime`数组、字符串数组或日期字符向量 | `char`、`string`、`datetime` | | `DirFlag` | 工作日约定，可以是`follow`（默认）、`modifiedfollow`、`previous`或`modifiedprevious`，也可以是搜索方向的标量、向量或矩阵（`Next`为`1`，`Previous`为`-1`） | `double`、`char`、`datetime` | | `Holiday` | 节假日和非交易日日期，可以是`datetime`数组、字符串数组或日期字符向量 | `char`、`string`、`datetime` | | `Weekend` | 周末日期，默认是`[1 0 0 0 0 0 1]`（周六和周日为周末），可以是长度为7的向量，其中`1`表示周末日期 | `double` | ##### 1.5 输出参数 `Busday`：下一个或上一个工作日，根据`Holiday`的定义，以标量、向量或矩阵的形式返回。 ##### 1.6 版本历史 - 该函数在R2006a之前引入。 - 从R2022b开始，不推荐使用序列日期数作为输入，建议使用`datetime`值。 #### 2. `busdays`：计算给定时间段内的工作日 `busdays`函数用于计算给定时间段内的工作日。 ##### 2.1 语法 ```matlab bdates = busdays(sdate,edate) bdates = busdays( ___ ,bdmode,Holiday) ``` ##### 2.2 描述 - `bdates = busdays(sdate,edate)`：生成包含开始日期（`sdate`）的时间段的最后一个工作日和包含结束日期（`edate`）的时间段的最后一个工作日之间的工作日向量。 - `bdates = busdays( ___ ,bdmode,Holiday)`：使用可选输入参数生成包含开始日期（`sdate`）的时间段的最后一个工作日和包含结束日期（`edate`）的时间段的最后一个工作日之间的工作日向量。如果未提供`Holiday`，则根据美国节假日生成日期。如果未提供`bdmode`，则生成每日向量。 ##### 2.3 示例 ```matlab % 确定每周时间段内的工作日 bdates = datestr(busdays('1/2/01','1/9/01','weekly')) bdates = 2x11 char array '05-Jan-2001' '12-Jan-2001' % 使用datetime输入确定每周时间段内的工作日 bdates = busdays(datetime('2-Jan-2001','Locale','en_US'),'9-Jan-2001','weekly') bdates = 2x1 datetime 05-Jan-2001 12-Jan-2001 % 确定每月时间段内的工作日 vec = datestr(busdays('1/8/16','3/1/16','monthly')) vec = 3x11 char array '29-Jan-2016' '29-Feb-2016' '31-Mar-2016' ``` ##### 2.4 输入参数 | 参数 | 描述 | 数据类型 | | ---- | ---- | ---- | | `sdate` | 开始日期，可以是`datetime`标量、字符串标量或日期字符向量 | `char`、`string`、`datetime` | | `edate` | 结束日期，可以是`datetime`标量、字符串标量或日期字符向量 | `char`、`string`、`datetime` | | `bdmode` | 工作日频率，可以是`DAILY`（默认）、`WEEKLY`、`MONTHLY`、`QUARTERLY`、`SEMIANNUAL`或`ANNUAL` | `double`、`char` | | `Holiday` | 节假日和非交易日日期，可以是`datetime`数组、字符串数组或日期字符向量 | `char`、`string`、`datetime` | ##### 2.5 输出参数 `bdates`：工作日，以列向量的形式返回，日期格式为`datetime`（如果`sdate`、`edate`或`Holiday`是`datetime`格式）。 ##### 2.6 版本历史 - 该函数在R2006a之前引入。 - 从R2022b开始，不推荐使用序列日期数作为输入，建议使用`datetime`值。 #### 3. `candle`：绘制蜡烛图 `candle`函数用于绘制证券的开盘价、最高价、最低价和收盘价的蜡烛图。 ##### 3.1 语法 ```matlab candle(Data) candle(Data,Color) h = candle(ax ___ ) ``` ##### 3.2 描述 - `candle(Data)`：根据给定的开盘价、最高价、最低价和收盘价数据绘制蜡烛图。如果收盘价大于开盘价，则蜡烛体（开盘价和收盘价之间的区域）为空心；否则为实心。 - `candle(Data,Color)`：添加可选的颜色参数。 - `h = candle(ax ___ )`：添加可选的坐标轴对象参数。 ##### 3.3 示例 ```matlab % 生成股票数据系列的蜡烛图 load SimulatedStock.mat; candle(TMW(end-20:end,:),'b'); title('Candlestick chart for TMW') ``` ##### 3.4 输入参数 | 参数 | 描述 | 数据类