morningman opened a new pull request, #4619:
URL: https://github.com/apache/doris-website/pull/4619
The 3.x DATE_TRUNC reference lists both argument orders without stating when
the time-unit-first form became available. On older 3.0 releases,
`DATE_TRUNC('year', '2025-04-28 12:12:12')` raises the reported second-argument
error.
Document both-order support from 3.0.5 (also present throughout 3.1), direct
earlier 3.0 users to the datetime-first form, and show equivalent
year-truncation examples in English and Chinese.
Fixes #2339. Also addresses the version ambiguity reported in #4108.
Source evidence: [3.0 backport
#49660](https://github.com/apache/doris/pull/49660), commit
`85c820723754825af1010e415590a94a7e154dc4`. Its parent accepts the time unit
only as the second argument; the change adds both-order signatures, validation,
execution and regression coverage. The first 3.0 release tag containing it is
`3.0.5-rc01`; the 3.1 release history also contains it.
## Review and validation
| Checkpoint | Conclusion |
| --- | --- |
| Goal | Explains the reported error and supplies the compatible argument
order. |
| Scope | Version note and one paired example in existing 3.x function
pages. |
| Versions/locales | 3.x EN/ZH synchronized. Dev/4.x already support both
orders; archives untouched. |
| Links/navigation | No route, heading, sidebar or link changes. |
| Framework | Not affected. |
| Validation | Source and release-tag ancestry checked; paired SQL/output
blocks match; JSON front matter parsed; `git diff --check` passed. No live SQL
or site build run. |
| Other issues | No introduced issue found in self-review; no exact patch
version inferred for either reporter. |
## Versions
- [ ] dev
- [ ] 4.x
- [x] 3.x
- [ ] 2.1 or older
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [x] Checked by AI
- [ ] Test Cases Built
- [x] Updated required version and language counterparts, or explained why
not
- [x] Updated both language counterparts
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
