Skip to content

Conversation

@bohutang
Copy link
Member

@bohutang bohutang commented Nov 5, 2025

Summary

This PR adds comprehensive documentation for the TIMESTAMP_TZ data type introduced in v1.2.834.

Changes

  • Data Type Table: Added TIMESTAMP_TZ with aliases and format specification
  • Dedicated Sections: Created separate sections for DATE, TIMESTAMP, and TIMESTAMP_TZ
  • Practical Examples: Included clear SQL examples demonstrating timezone behavior
  • Use Case Guidance: Added recommendations for when to use each type
  • Formatting: Fixed table alignment issues
  • Bilingual: Updated both English and Chinese documentation

Key Features Documented

  • TIMESTAMP stores UTC internally and displays based on session timezone
  • TIMESTAMP_TZ preserves the original timezone offset
  • Important note about daylight saving time limitations
  • Clear examples showing the difference in behavior

Reference

Related to PR: databendlabs/databend#18892

- Add TIMESTAMP_TZ type to datetime data types table
- Add separate sections for DATE, TIMESTAMP, and TIMESTAMP_TZ with examples
- Include timezone behavior explanations and use cases
- Update version to v1.2.834
- Fix table formatting alignment
- Add both English and Chinese documentation
@vercel
Copy link

vercel bot commented Nov 5, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Nov 5, 2025 1:26pm

@bohutang
Copy link
Member Author

bohutang commented Nov 5, 2025

cc @KKould

@bohutang bohutang merged commit 0ea01c8 into main Nov 5, 2025
4 checks passed
@bohutang bohutang deleted the docs/update-timestamp-tz-documentation branch November 5, 2025 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants