asFreq

asFreq(X, rule, [closed], [label], [origin='start_day'])

转换给定数据的时间频率。与 resample 函数不同，该函数不可使用聚合函数对数据进行处理。

X 是有时间类型索引的矩阵（由 setIndexedMatrix! 创建）或序列（由 setIndexedSeries! 创建）。

rule 可以是一个字符串，可取以下值，亦可为一个时间类型的向量。

上述字符串亦可配合使用数字（必须为正整数），例如 "2M" 表示频率为每两个月月末。此外，rule 也可以是交易日历标识（国外交易所的 ISO Code、国内交易所简称或自定义交易日历名称），以便基于交易日历进行计算。交易日历也可以配合使用数字，表示多个交易日，此时只能指定由4个大写字母组成的交易日历标识。例如：“2XSHG”，表示上海证券交易所每两个交易日。

closed 字符串，表示分组区间哪一个边界是闭合的。

• rule 为 'M', 'A', 'Q', 'BM', 'BA', 'BQ' 和 'W' 时，closed 的默认取值为 'right' ，否则，closed 的默认取值为 'left'。
• origin 取 'end' 或者 'end_day' 时，closed 的默认值为 'right'。

label 字符串，表示将分组区间的哪一个边界作为 label 输出。

• rule 为 'M', 'A', 'Q', 'BM', 'BA', 'BQ' 和 'W' 时，label 的默认取值为 'right' ，否则，label 的默认取值为 'left'。
• origin 取 'end' 或者 'end_day' 时，label 的默认值为 'right'。

origin 字符串或和 X 具有相同时间类型的标量，表示基于时间戳调整分组。取值为 'epoch', start', 'start_day', 'end', 'end_day' 或自定义的时间对象，默认值为 'start_day'。

• 'epoch'：分组起始点为1970-01-01。
• 'start'：分组起始点为时间序列的第一个值。
• 'start_day'：分组起始点是时间序列的第一个值对应日期的午夜零点。
• 'end'：分组起始点是时间序列的最后一个时间戳。
• 'end_day'：分组起始点是时间序列的最后一个时间戳对应日期的午夜24点（即下一日的零点）。

index = [2000.01.01, 2000.01.31, 2000.02.15, 2000.02.20, 2000.03.31, 2000.04.16, 2000.05.06, 2000.08.31]
s = indexedSeries(index, 1..8)
s

s.asFreq("M")

s.asFreq("2M")

index = [2020.01.01, 2020.01.03, 2020.01.06]
s = indexedSeries(index, 1..3)
s

s.asFreq("D")

s.asFreq("2D")

index = temporalAdd(2022.10.01 23:30:00,7*(0..8),`m)
s = indexedSeries(index, 3*(0..8))
s.asFreq("8min")

s.asFreq(rule=`8min,closed=`right)

s.asFreq(rule=`8min,closed=`right,origin=`end)