你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
startofyear()
适用于：✅Microsoft Fabric✅Azure 数据资源管理器Azure Monitor✅Microsoft✅ Sentinel
返回包含日期的年份的起点，偏移某个偏移量（如已提供）。
语法
startofyear(date [, offset ])
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 描述 |
|---|---|---|---|
| date | datetime |
✔️ | 要查找其所对应年份的开始时间的日期。 |
| offset | int |
从输入日期偏移的年数。 默认值为 0。 |
返回
一个日期/时间，表示给定 date 值的那一年的开始（如果指定了偏移量，则还包含该信息）。
示例
range offset from -1 to 1 step 1
| project yearStart = startofyear(datetime(2017-01-01 10:10:17), offset)
输出
| yearStart |
|---|
| 2016-01-01 00:00:00.0000000 |
| 2017-01-01 00:00:00.0000000 |
| 2018-01-01 00:00:00.0000000 |