# 金融 / 专题函数 / 因子研究 / 因子研究01：Fama-French三四五因子 / 应用模型 / 取数接口

## `famaFrench_factorRet_fixedInterval(beg_t, end_t, model_type, weight_type, m, modelflag)`

声明：function

计算三四五因子区间固定间隔收益率(%)，与参数M设置相关

<!-- tags: 金融 专题函数 因子研究 应用模型 取数接口 查找 搜索 lookup 计算 求解 -->

| 参数          | 类型     | 说明                                                                                                                                                                                       |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `beg_t`       | datetime | 开始日，日期类型                                                                                                                                                                           |
| `end_t`       | datetime | 截止日，日期类型                                                                                                                                                                           |
| `model_type`  | integer  | 计算模型，整型，取值如下                                                                                                                                                                   |
| `weight_type` | integer  | 因子加权方式，整型，取值如下                                                                                                                                                               |
| `m`           | integer  | 固定间隔数，整型，由区间截止日、从后往前推移，每M个日线为一个划分子区间。若滚动推移到第一个子区间不足M个交易日时，则使用实际间隔（小于M）来计算。M=5常表示滚动周线，M=20常表示滚动月线，…… |
| `modelflag`   | integer  | 模型标识，字符串型，取值如下                                                                                                                                                               |

返回：array

### 示例

范例01：调用 FamaFrench_FactorRet_FixedInterval

```tsl
BegT := 20221001T;
EndT := 20221231T;
ModelType := 2; // 四因子
WeightType := 2; // 等权
M := 20;
Modelflag := "DV";
return FamaFrench_FactorRet_FixedInterval(BegT, EndT, ModelType, WeightType, M, Modelflag);
```

## `famaFrench_factorRet_marketCycle(beg_t, end_t, model_type, weight_type, cycle, if_qk_info, modelflag)`

声明：function

计算三四五因子区间市场周期收益率(%)，与参数Cycle设置相关

<!-- tags: 金融 专题函数 因子研究 应用模型 取数接口 查找 搜索 lookup 计算 求解 -->

| 参数          | 类型     | 说明                                                                                                                                             |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `beg_t`       | datetime | 开始日，日期类型                                                                                                                                 |
| `end_t`       | datetime | 截止日，日期类型                                                                                                                                 |
| `model_type`  | integer  | 计算模型，整型，取值如下                                                                                                                         |
| `weight_type` | integer  | 因子加权方式，整型，取值如下                                                                                                                     |
| `cycle`       | string   | 因子取数周期，字符串类型，仅支持日线及以下的低频周期，取值如下                                                                                   |
| `if_qk_info`  | bool     | 是否返回区间划分信息，布尔类型，默认为假 为真，返回“截止日”、“实际开始日”、“实际截止日”及因子名称字段； 为假【默认】，返回“截止日”及因子名称字段 |
| `modelflag`   | integer  | 模型标识，字符串型，取值如下                                                                                                                     |

返回：array

### 示例

范例01：调用 FamaFrench_FactorRet_MarketCycle

```tsl
BegT := 20221205T;  // 区间第一个周线2022-12-09的完整周期统计开始日
EndT := 20221230T;
ModelType := 1; // 三因子
WeightType := 1; // 自由流通股本加权
Cycle := cy_week();
IfQKInfo := 0;
Modelflag := "DV";
return FamaFrench_FactorRet_MarketCycle(BegT, EndT, ModelType, WeightType, Cycle, IfQKInfo, Modelflag);
```

范例02：调用 FamaFrench_FactorRet_MarketCycle

```tsl
BegT := 20230116T;
EndT := 20230227T;
ModelType := 1;  // 三因子
WeightType := 2; // 等权
cycle := cy_month();
IfQKInfo := 0;
Modelflag := "DV";
return FamaFrench_FactorRet_MarketCycle(BegT, EndT, ModelType, WeightType, Cycle, IfQKInfo, Modelflag);
```

范例03：调用 FamaFrench_FactorRet_MarketCycle

```tsl
BegT := 20230116T;
EndT := 20230227T;
ModelType := 1;  // 三因子
WeightType := 2; // 等权
cycle := cy_month();
IfQKInfo := 1;
Modelflag := "DV";
return FamaFrench_FactorRet_MarketCycle(BegT, EndT, ModelType, WeightType, Cycle, IfQKInfo, Modelflag);
```
