[doc] Add docs for HUMAN_READABLE_SECONDS function

[prakash-atul]

This document describes the HUMAN_READABLE_SECONDS function, detailing its behavior, syntax, parameters, return value, special cases, and examples of usage.

Versions

• dev
• 4.x
• 3.x
• 2.1 or older (not covered by version/language sync gate)

Languages

• Chinese
• English
• Japanese candidate translation needed

Docs Checklist

• Checked by AI
• Test Cases Built
• Updated required version and language counterparts, or explained why not
• If only one language changed, confirmed whether source/translation counterparts need sync

Notes

• Added English documentation only because the function is newly introduced and does not yet exist in released branches.
• Chinese and Japanese translations can be added later during documentation synchronization.
• Regression tests and FE/BE consistency tests were added together with the implementation.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds English documentation for the HUMAN_READABLE_SECONDS scalar date-time function, describing its behavior, syntax, parameters, special cases, and example usage.

Changes:

• New markdown documentation page for HUMAN_READABLE_SECONDS.
• Documents Presto/Trino-compatible semantics (rounding, negative values, NaN/Infinity rejection).
• Provides multiple example queries with expected output.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.