# 数据仓库 / 财务函数 ## `baseExists(info_id, order)` 声明：function 返回是否存在某项和报告期无关的数据，例如公司简称、注册地址等 | 参数 | 类型 | 说明 | | --------- | ---- | ----------------------------------------------------------------------- | | `info_id` | int | 信息类别代码，infoID参见附录 | | `order` | int | 省略此参数取最后一次更新，否则为第几条数据。0表示第一条，-1表示最后一条 | 返回：bool ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SZ000002'); if BaseExists(10002) then return base(10002); ``` ## `basicIdExists(id)` 声明：function 返回某信息ID是否存在 | 参数 | 类型 | 说明 | | ---- | ---- | ------------------ | | `id` | int | 整数，某信息的ID号 | 返回：bool ### 示例 范例01：返回1，表示存在 ```tsl infoid := DatabaseInfoArrayId(21); return BasicIDExists(infoid); // 输出：1，表示存在 ``` ## `bName(info_id)` 声明：function 返回某信息ID的含义。另，用户也可以通过F11快捷键进行查询 | 参数 | 类型 | 说明 | | --------- | ---- | --------------------- | | `info_id` | int | 整数,某信息对应的ID号 | 返回：string ### 示例 范例01：返回”红利比”，即用18007可提取红利比数据 ```tsl return bName(18007); // 输出："红利比"，即用18007可提取红利比数据。 ``` ## `idfType(id)` 声明：function 返回某信息ID的数据类型 | 参数 | 类型 | 说明 | | ---- | ---- | ------------------ | | `id` | int | 整数，某信息的ID号 | 返回：int ### 示例 范例01：调用 idfType ```tsl TYPES := array( '整型', '实数', '字符', '表格'); TYPES[-1] := '未知'; return array('公司全称':TYPES[idftype(10002)], '红利比':TYPES[idftype(18007)], '分红送股表':TYPES[idftype(18)], '未知':TYPES[idftype(99)]); ``` ## `idtType(info_id)` 声明：function 返回某信息ID的类型 | 参数 | 类型 | 说明 | | --------- | ---- | --------------------- | | `info_id` | int | 整数,某信息对应的ID号 | 返回：int ### 示例 范例01：调用 idtType ```tsl TYPES := array( '', '报告期相关', '报告期无关', '报表'); TYPES[-1] := '未知'; return array('公司全称':TYPES[idttype(10002)], '红利比':TYPES[idttype(18007)], '分红送股表':TYPES[idttype(18)], '未知':TYPES[idttype(99)]); ``` ## `infoArray(info_id)` 声明：function 返回某项内容的历史纪录，是一个表结构。例如：分红送股，配股的历史纪录（二维表） | 参数 | 类型 | 说明 | | --------- | ------- | ---------------------------------- | | `info_id` | integer | 整数，信息类别代码，infoID参见附录 | 返回：array ### 示例 范例01：获取万科A分红送股表数据 ```tsl // 获取万科A分红送股表数据 setsysparam(pn_stock(), 'SZ000002'); // 分红送股表ID infoid := DatabaseInfoArrayId(21); return infoarray(infoid); ``` ## `infoArrayExists(info_id)` 声明：function 返回某项表格内容是否存在 | 参数 | 类型 | 说明 | | --------- | ---- | ---------------------------------- | | `info_id` | int | 代码，信息类别代码，infoID参见附录 | 返回：bool ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SH601888'); return InfoArrayExists(20); ``` ## `last12MData(r_date, info_id, get_the_nearest)` 声明：function 返回指定报告期RDate往前12个月的某项财务指标的值。函数只能提取与报告期相关的数据。 该模型与当前的时间有关。因为财务数据有调整前调整后的数据，提取数据的时候，要注意设置当前的时间。如果要取调整前的数据，当前的日期，要设置在调整后数据公布日之前。 比如股票A，2011年的年报是2012年4月15日公布，2012年年报是2013年4月15日公布，2012年年报披露的时候，同时会披露2011年年报调整后的数据。 当前的时间pn_date()设置在2013年4月15日之前的时候，取到的2011年年报数据就是调整前的数据，否则，取到的是2011年调整后的数据。 与系统参数pn_stock()、pn_date()相关，默认时间为今天 | 参数 | 类型 | 说明 | | ----------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `r_date` | int | 整数报告期，一般为YEAR + Code指定，Code为0630表示中报，1231表示年报，0331第一季度，0930第三季度。如20170930；0001为自然周第一周周报，0002为第二周，以此类推。以周为报告期的日期，主要用于提取封闭式基金的净值数据。如20170001；另外，使用0表示最新报告期 | | `info_id` | int | 整数，信息类别代码，即财务指标和其他信息的ID，可以通过证券数据专家或基本面信息（F11）查询 | | `get_the_nearest` | bool | 布尔值，如无指定报告，是否找最接近的报告数据。1为是，0为否 | 返回：float ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SZ000001'); setsysparam(pn_date(), 20171031T); return Last12MData(20170930, 46002); ``` ## `lastQuarterData(r_date, info_id, get_the_nearest)` 声明：function 返回某个季度RDate的某项财务指标的值。函数只能提取与报告期相关的数据。季度数据如一季度（1-3月）、二季度（4-6月）、三季度（7-9月）、四季度（10-12月），目前在内地交易所没有要求上市企业公布季度报表，所以我们季度数据需要计算出来。 该模型与当前的时间有关。因为财务数据有调整前调整后的数据，提取数据的时候，要注意设置当前的时间。如果要取调整前的数据，当前的日期，要设置在调整后数据公布日之前。 比如股票A，2011年的年报是2012年4月15日公布，2012年年报是2013年4月15日公布，2012年年报披露的时候，同时会披露2011年年报调整后的数据。 当前的时间pn_date()设置在2013年4月15日之前的时候，取到的2011年年报数据就是调整前的数据，否则，取到的是2011年调整后的数据。 与系统参数pn_stock()、pn_date()相关，默认时间为今天 | 参数 | 类型 | 说明 | | ----------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `r_date` | int | 整数报告期，一般为YEAR + Code指定，Code为0630表示中报，1231表示年报，0331第一季度，0930第三季度。如20170930；0001为自然周第一周周报，0002为第二周，以此类推。以周为报告期的日期，主要用于提取封闭式基金的净值数据。如20170001；另外，使用0表示最新报告期 | | `info_id` | int | 整数，信息类别代码，即财务指标和其他信息的ID，可以通过证券数据专家或基本面信息（F11）查询 | | `get_the_nearest` | bool | 布尔值，如无指定报告，是否找最接近的报告数据。1为是，0为否 | 返回：float ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SZ000001'); setsysparam(pn_date(), 20171031T); return LastQuarterData(20170930, 46002, 0); ``` ## `reportExists(info_id, report_id)` 声明：function 返回是否存在某个报告期的某项财务指标 | 参数 | 类型 | 说明 | | ----------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `info_id` | int | 信息类别代码，包括财务指标和其他信息，每项信息有一个InfoID编号，infoID参见附录 | | `report_id` | int | 报告期代码，一般为YEAR + Code指定，Code为0630表示中报，1231表示年报。0331第一季度，0930第三季度。0001为自然周第一周周报，0002为第二周，以此类推如果ReportID，使用0表示最新报告期 | 返回：bool ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SH601888'); return ReportExists(18007, 20101231); // 输出：1,是 ``` ## `reportHist(infoid, find_v)` 声明：function 返回一个数组，公布了包含infoID的所有报告期列表，例如返回(19991231,20000630,20001231)表示含有InfoID所指数据的报告有1999年年报，2000年中报以及2001年年报。 如果存在FindV参数，则仅返回报告期ID与FindV最接近且不大于的报告期 | 参数 | 类型 | 说明 | | --------- | ---- | ----------------------------------------------------------------- | | `infoid` | int | 数据表字段代码，infoID参见附录。如合并利润表中营业收入的ID为46002 | | `find_v` | int | 可选参数，查找的报告期，如20131231 | 返回：array ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SH601888'); infoid := DataBaseRatioId(1); return ReportHist(infoid); ``` ## `reportHistExists(infoid)` 声明：function 返回某项数据是否存在有报告 | 参数 | 类型 | 说明 | | --------- | ---- | ---------------------------- | | `infoid` | int | 信息类别代码，infoID参见附录 | 返回：bool ### 示例 范例01：调用函数 ```tsl setsysparam(pn_stock(), 'SZ300002'); return ReportHistExists(18007); ```