clickhouse周toWeek函数
toWeek(date[,mode])
返回Date或DateTime的周数。两个参数形式可以指定星期是从星期日还是星期一开始，以及返回值应在0到53还是从1到53的范围内。如果省略了mode参数，则默认 模式为0。
| Mode | First day of week | Range | Week 1 is the first week … |
|---|---|---|---|
| 0 | Sunday | 0-53 | with a Sunday in this year |
| 1 | Monday | 0-53 | with 4 or more days this year |
| 2 | Sunday | 1-53 | with a Sunday in this year |
| 3 | Monday | 1-53 | with 4 or more days this year |
| 4 | Sunday | 0-53 | with 4 or more days this year |
| 5 | Monday | 0-53 | with a Monday in this year |
| 6 | Sunday | 1-53 | with 4 or more days this year |
| 7 | Monday | 1-53 | with a Monday in this year |
| 8 | Sunday | 1-53 | contains January 1 |
| 9 | Monday | 1-53 | contains January 1 |
这张图用来方便下面的测试
模式0 默认模式:
一周的第一天是周日,第一周是今年第一个有周日的周
toWeek(toDate('2020-01-01'), 0) 为0, toYearWeek(toDate('2020-01-01'), 0) 为201952
toWeek(toDate('2020-01-05'), 0) 为1, toYearWeek(toDate('2020-01-05'), 0) 为202001
模式1:
一周的第一天是周一,第一周是今年第一个有4天或4天以上的周,第一周之前的今年的日期为第0周
toWeek(toDate('2020-01-01'), 1) 为1
toWeek(toDate('2021-01-01'), 1) 为0, toYearWeek(toDate('2021-01-01'), 1) 为202053
模式3:
一周的第一天是周一,第一周是今年第一个有4天或4天以上的周,第一周之前的今年的日期为上一年的第52/53周,即最后一周
toWeek(toDate('2020-01-01'), 3) 为1
toWeek(toDate('2021-01-01'), 3) 为53(上一年最后一周), toYearWeek(toDate('2021-01-01'), 3) 为202053
toWeek(toDate('2022-01-01'), 3) 为52(上一年最后一周), toYearWeek(toDate('2022-01-01'), 3) 为202152
模式5:
一周的第一天是周一,第一周是今年第一个有星期一的周,第一周之前的今年的日期为第0周
toWeek(toDate('2020-01-01'), 5) 为0
toWeek(toDate('2024-01-01'), 5) 为1
模式7:
一周的第一天是周一,第一周是今年第一个有星期一的周,第一周之前的今年的日期为上一年的第52或53周,即最后一周
toWeek(toDate('2019-01-01'), 7) 为53, toYearWeek(toDate('2019-01-01'), 7) 为 201853
toWeek(toDate('2020-01-01'), 7) 为52, toYearWeek(toDate('2020-01-01'), 7) 为 201952
toWeek(toDate('2024-01-01'), 7) 为1
模式9:
一周的第一天是周一,第一周是第一个包含1月1日的周,第一周中的去年的日期也算作今年的第1周
toWeek(toDate('2019-12-29'), 9) 为52
toWeek(toDate('2019-12-30'), 9) 为1
toWeek(toDate('2019-12-31'), 9) 为1
toWeek(toDate('2020-01-01'), 9) 为1
toYearWeek(date[,mode])
返回Date的年和周。 结果中的年份可能因为Date为该年份的第一周和最后一周而与Date的年份不同。
mode参数的工作方式与toWeek()的mode参数完全相同。 对于单参数语法，mode使用默认值0。
如果toWeek()返回为0, 那么toYearWeek()返回的周为去年的最后一周
toWeek(toDate('2020-01-01'), 0) 为0, toYearWeek(toDate('2020-01-01'), 0) 为201952
toStartOfWeek(t[,mode])
按mode将Date或DateTime向前取整到最近的星期日或星期一。 返回Date类型。 mode参数的工作方式与toWeek()的mode参数完全相同。 对于单参数语法，mode使用默认值0。
toStartOfWeek(toDate('2021-01-10 12:00:30'), 7) 为 2021-01-04
参考
ClickHouse时间日期函数
https://clickhouse.com/docs/zh/sql-reference/functions/date-time-functions#toweek
