[WIP] Document date/time function additions to the SQL API for Analytics

Author: 46bit

src/content/docs/analytics/analytics-engine/sql-reference/aggregate-functions.mdx

@@ -248,3 +248,57 @@ SELECT topKWeighted(double1, _sample_interval) FROM my_dataset
 -- find the 15 most common values of <blob1>, weighted by `_sample_interval`
 SELECT topKWeighted(15)(blob1, _sample_interval) FROM my_dataset
 ```
+
+## countIf
+
+Usage:
+
+```sql
+countIf(<expr>)
+```
+
+`countIf` is an aggregation function that returns the number of rows in the results set,
+but only counting rows where a provided expression evaluates to true.
+
+Example:
+
+```sql
+-- return the number of rows where `double1` is greater than 5
+count(double1 > 5)
+```
+
+## sumIf
+
+Usage:
+
+```sql
+sumIf(<expr>, <expr>)
+```
+
+`sumIf` is an aggregation function that returns the sum of a first expression across all rows in the results set,
+but only including rows where a second expression evaluates to true.
+
+Example:
+
+```sql
+-- return the sum of column `item_cost` of all items where another column `in_stock` is not zero
+sumIf(item_cost, in_stock > 0)
+```
+
+## avgIf
+
+Usage:
+
+```sql
+avgIf(<expr>, <expr>)
+```
+
+`avgIf` is an aggregation function that returns the mean of an expression across all rows in the results set,
+but only including rows where a second expression evaluates to true.
+
+Example:
+
+```sql
+-- return the mean of column `item_cost` where another column `in_stock` is not zero
+avg(item_cost, in_stock > 0)
+```

src/content/docs/analytics/analytics-engine/sql-reference/date-time-functions.mdx

@@ -119,3 +119,223 @@ FROM your_dataset
 GROUP BY hour
 ORDER BY hour ASC
 ```
+
+## toYear
+
+Usage:
+
+```sql
+toYear(<datetime>)
+```
+
+`toYear` returns the year of a datetime.
+
+Examples:
+
+```sql
+-- returns the number 2025
+toYear(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toMonth
+
+Usage:
+
+```sql
+toMonth(<datetime>)
+```
+
+`toMonth` returns the year of a datetime.
+
+Examples:
+
+```sql
+-- returns the number 10
+toMonth(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toDayOfMonth
+
+Usage:
+
+```sql
+toDayOfMonth(<datetime>)
+```
+
+`toDayOfMonth` returns the day of the month from a datetime.
+
+Examples:
+
+```sql
+-- returns the number 27
+toDayOfMonth(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toHour
+
+Usage:
+
+```sql
+toHour(<datetime>)
+```
+
+`toHour` returns the hour of the day from a datetime.
+
+Examples:
+
+```sql
+-- returns the number 9
+toHour(toDateTime('2025-10-27 09:11:13'))
+```
+
+## toMinute
+
+Usage:
+
+```sql
+toMinute(<datetime>)
+```
+
+`toMinute` returns the minute of the hour from a datetime.
+
+Examples:
+
+```sql
+-- returns the number 11
+toMinute(toDateTime('2025-10-27 09:11:13'))
+```
+
+## toSecond
+
+Usage:
+
+```sql
+toSecond(<datetime>)
+```
+
+`toSecond` returns the second of the minute from a datetime.
+
+Examples:
+
+```sql
+-- returns the number 13
+toSecond(toDateTime('2025-10-27 09:11:13'))
+```
+
+## toStartOfYear
+
+Usage:
+
+```sql
+toStartOfYear(<datetime>)
+```
+
+`toStartOfYear` rounds down a datetime to the nearest start of year. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-01-01 00:00:00
+toStartOfYear(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toStartOfMonth
+
+Usage:
+
+```sql
+toStartOfMonth(<datetime>)
+```
+
+`toStartOfMonth` rounds down a datetime to the nearest start of month. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-10-01 00:00:00
+toStartOfMonth(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toStartOfDay
+
+Usage:
+
+```sql
+toStartOfDay(<datetime>)
+```
+
+`toStartOfDay` rounds down a datetime to the nearest start of day. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-10-27 00:00:00
+toStartOfDay(toDateTime('2025-10-27 00:00:00'))
+```
+
+## toStartOfHour
+
+Usage:
+
+```sql
+toStartOfHour(<datetime>)
+```
+
+`toStartOfHour` rounds down a datetime to the nearest start of hour. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-10-27 16:00:00
+toStartOfHour(toDateTime('2025-10-27 16:55:25'))
+```
+
+## toStartOfFifteenMinutes
+
+Usage:
+
+```sql
+toStartOfFifteenMinutes(<datetime>)
+```
+
+`toStartOfFifteenMinutes` rounds down a datetime to the nearest fifteen minutes. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-10-27 16:45:00
+toStartOfFifteenMinutes(toDateTime('2025-10-27 16:55:25'))
+```
+
+## toStartOfMinute
+
+Usage:
+
+```sql
+toStartOfMinute(<datetime>)
+```
+
+`toStartOfMinute` rounds down a datetime to the nearest minute. This can be useful
+for grouping data into equal-sized time ranges.
+
+Examples:
+
+```sql
+-- round a timestamp down to 2025-10-27 16:55:00
+toStartOfMinute(toDateTime('2025-10-27 16:55:25'))
+```
+
+## today
+
+Usage:
+
+```sql
+now()
+```
+
+Returns the current date as a `Date`.