Prometheus 内置函数：year() 用于从时间戳中提取年份

作用

year() 函数用于从时间戳中提取年份。当你对一个时间序列的样本使用时间戳时，这个函数非常有用。

year() 函数将返回一个瞬时向量，其中每个样本的值都是原始时间戳对应的年份。

注意：year() 函数仅提取年份信息，并返回一个整数，它不会考虑时区或其他时间相关的细节。

语法

year() 函数的语法如下：

year(<vector>)

参数说明：

• <vector> 是一个包含时间戳的向量表达式。

示例

假设你有一个名为 prometheus_http_requests_total 的时间序列，并且你想要知道每个请求发生的年份，执行如下查询：

year(prometheus_http_requests_total)

上述查询将返回一个瞬时向量，其中每个请求样本的时间戳都被转换为对应的年份。运行查询，如下图：

如果执行 year() 函数时，如果没有传递任何参数，将返回当前年份，如下图：