Skip to content

Conversation

@CybotTM
Copy link
Member

@CybotTM CybotTM commented Nov 28, 2025

Summary

Add comprehensive documentation for Daylight Saving Time (DST) handling behavior.

Changes

  • docs/DST_HANDLING.md: New comprehensive documentation covering:

    • Spring forward behavior (ISC cron-compatible)
    • Fall back behavior (uses first occurrence)
    • Midnight DST transitions (e.g., Sao Paulo, Brazil)
    • Timezone configuration options (WithLocation, TZ= prefix)
    • Testing strategies for DST scenarios
    • Best practices and known limitations
    • Code examples and reference links
  • README.md: Updated timezone section with:

    • Concise DST behavior table
    • Link to detailed documentation
    • Changed WARNING to TIP for better UX

Test plan

  • go build ./... compiles successfully
  • go test ./... passes all tests
  • golangci-lint run ./... reports no issues
  • Documentation renders correctly in GitHub markdown

Fixes #70

Add docs/DST_HANDLING.md with comprehensive documentation covering:
- Spring forward behavior (ISC cron-compatible)
- Fall back behavior (uses first occurrence)
- Midnight DST transitions (e.g., Sao Paulo)
- Timezone configuration options
- Testing strategies for DST scenarios
- Best practices and known limitations

Update README.md with concise DST behavior table and link to
detailed documentation.

Fixes #70
@CybotTM CybotTM merged commit b87fc21 into main Nov 28, 2025
25 of 26 checks passed
@CybotTM CybotTM deleted the docs/70-dst-handling branch November 28, 2025 13:15
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.

Document DST handling behavior comprehensively

2 participants