✨ feat(tsl-api-reference): expand and reorganize api catalog

Flatten builtin pages, add third-party and platform scopes, and import financial and data warehouse references. Keep the existing generated index without rebuilding after signature normalization.
2026-08-10 18:26:24 +08:00
parent 2938300acb
commit 9010829c6d
1186 changed files with 243901 additions and 219769 deletions
@@ -0,0 +1,480 @@
+# 金融 / 财务分析 / 偿债能力
+
+## `buyerAdvancesToMainIncomeRatio(report_date)`
+
+声明：function
+
+预收帐款与主营收入比(%)
+
+| 参数          | 类型    | 说明     |
+| ------------- | ------- | -------- |
+| `report_date` | integer | 报告期； |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报白云机场的预收帐款与主营收入比(%)
+
+```tsl
+// 2024年年报白云机场的预收帐款与主营收入比(%)
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+v := BuyerAdvancesToMainIncomeRatio(20241231);
+
+return v;
+// 输出：2.6332
+```
+
+范例02：指定2024年一季报，取白云机场在报告期时的最近1年的会计年度报告期的预收帐款与主营收入比(%)
+
+```tsl
+// 指定2024年一季报，取白云机场在报告期时的最近1年的会计年度报告期的预收帐款与主营收入比(%)
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := BuyerAdvancesToMainIncomeRatio(20240331);
+
+return v;
+// 输出：0.537
+```
+
+范例03：取白云机场在2019年年报的预收帐款与主营收入比(%)调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的预收帐款与主营收入比(%)调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的流动资产合计数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := CurrentRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := CurrentRatio(RDate);
+
+return array(v1, v2); // array(0.3596,0.3621)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```
+
+## `currentRatio(report_date)`
+
+声明：function
+
+流动比率
+
+| 参数          | 类型    | 说明   |
+| ------------- | ------- | ------ |
+| `report_date` | integer | 报告期 |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报格力电器的流动比率
+
+```tsl
+// 2024年年报格力电器的流动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+v := CurrentRatio(20241231);
+
+return v;
+// 输出：1.1177
+```
+
+范例02：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的流动比率
+
+```tsl
+// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的流动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := CurrentRatio(20240331);
+
+return v;
+// 输出：1.1351
+```
+
+范例03：取白云机场在2019年年报的流动比率调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的流动比率调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的流动资产合计数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := CurrentRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := CurrentRatio(RDate);
+
+return array(v1, v2); // array(0.3596,0.3621)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```
+
+## `longDebtToNetAssetsandDebtRatio(report_date)`
+
+声明：function
+
+长期债务与营运资金比率
+
+| 参数          | 类型    | 说明     |
+| ------------- | ------- | -------- |
+| `report_date` | integer | 报告期； |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报格力电器的长期债务与营运资金比率
+
+```tsl
+// 2024年年报格力电器的长期债务与营运资金比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+v := LongDebtToNetAssetsandDebtRatio(20241231);
+
+return v;
+// 输出：1.0724
+```
+
+范例02：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的长期债务与营运资金比率
+
+```tsl
+// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的长期债务与营运资金比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := LongDebtToNetAssetsandDebtRatio(20240331);
+
+return v;
+// 输出：1.7094
+```
+
+范例03：取白云机场在2019年年报的长期债务与营运资金比率调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的长期债务与营运资金比率调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的流动资产合计数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := LongDebtToNetAssetsandDebtRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := LongDebtToNetAssetsandDebtRatio(RDate);
+
+return array(v1, v2); // array(-0.3332,-0.314)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```
+
+## `profitToFinancialExpenseRatio(report_date)`
+
+声明：function
+
+利息保障倍数
+
+| 参数          | 类型    | 说明   |
+| ------------- | ------- | ------ |
+| `report_date` | integer | 报告期 |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报白云机场的利息支付倍数
+
+```tsl
+// 2024年年报白云机场的利息支付倍数
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+v := ProfitToFinancialExpenseRatio(20241231);
+
+return v;
+// 输出：19.6848
+```
+
+范例02：指定2024三季报，取白云机场利息支付倍数的TTM
+
+```tsl
+// 指定2024三季报，取白云机场利息支付倍数的TTM
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+SetSysParam(CT_TTMData(), True); // 计算TTM
+
+v := ProfitToFinancialExpenseRatio(20240930);
+
+return v;
+// 输出：21.3088
+```
+
+范例03：指定2024年一季报，取白云机场在报告期时的最近1年的会计年度报告期的利息支付倍数
+
+```tsl
+// 指定2024年一季报，取白云机场在报告期时的最近1年的会计年度报告期的利息支付倍数
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := ProfitToFinancialExpenseRatio(20240331);
+
+return v;
+// 输出：8.2029
+```
+
+范例04：指定2024三季报，取白云机场2024第三季度单季度的利息支付倍数
+
+```tsl
+// 指定2024三季报，取白云机场2024第三季度单季度的利息支付倍数
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SH600004');
+
+SetSysParam(CT_QuarterData(), True); // 计算单季度
+
+v := ProfitToFinancialExpenseRatio(20240930);
+
+return v;
+// 输出：-0.12
+```
+
+范例05：取白云机场在2019年年报的利息支付倍数调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的利息支付倍数调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的财务费用数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := ProfitToFinancialExpenseRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := ProfitToFinancialExpenseRatio(RDate);
+
+return array(v1, v2); // array(25.3509,27.0408)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```
+
+## `quickRatio(report_date, dtype)`
+
+声明：function
+
+速动比率
+
+| 参数          | 类型    | 说明     |
+| ------------- | ------- | -------- |
+| `report_date` | integer | 报告期   |
+| `dtype`       | integer | 算法类型 |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报格力电器的速动比率
+
+```tsl
+// 2024年年报格力电器的速动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+v := QuickRatio(20241231);
+
+return v;
+// 输出：0.979
+```
+
+范例02：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的速动比率
+
+```tsl
+// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的速动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := QuickRatio(20240331, 2);
+
+return v;
+// 输出：0.7459
+```
+
+范例03：取白云机场在2019年年报的速动比率调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的速动比率调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的流动负债合计数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := QuickRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := QuickRatio(RDate);
+
+return array(v1, v2); // array(0.3503,0.3531)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```
+
+## `superQuickRatio(report_date)`
+
+声明：function
+
+超速动比率
+
+| 参数          | 类型    | 说明     |
+| ------------- | ------- | -------- |
+| `report_date` | integer | 报告期； |
+
+返回：real
+
+### 示例
+
+范例01：2024年年报格力电器的超速动比率
+
+```tsl
+// 2024年年报格力电器的超速动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+v := SuperQuickRatio(20241231);
+
+return v;
+// 输出：0.6486
+```
+
+范例02：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的超速动比率
+
+```tsl
+// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的超速动比率
+
+oV := BackUpSystemParameters2();
+
+setsysparam(pn_stock(), 'SZ000651');
+
+setsysparam(CT_YearData(), true); // 计算最近会计年度
+
+setsysparam(CT_RecentYear(), 1); // 最近1年
+
+v := SuperQuickRatio(20240331);
+
+return v;
+// 输出：0.6653
+```
+
+范例03：取白云机场在2019年年报的超速动比率调整前与调整后
+
+```tsl
+// 取白云机场在2019年年报的超速动比率调整前与调整后
+
+// 20210430公布的2020年年报对2019年年报中的预收帐款数据进行了调整
+
+setsysparam(pn_stock(), 'SH600004');
+
+RDate := 20191231;
+
+// 调整前：设置指定日早于调整后公布日
+
+setsysparam(pn_date(), 20200630T);
+
+v1 := BuyerAdvancesToMainIncomeRatio(RDate);
+
+// 调整后：设置指定日晚于调整后公布日
+
+setsysparam(pn_date(), 20211024T);
+
+v2 := BuyerAdvancesToMainIncomeRatio(RDate);
+
+return array(v1, v2); // array(1.0959,1.1001)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
+```