Skip to content

Conversation

@semoi
Copy link
Owner

@semoi semoi commented Nov 23, 2025

Addresses GitHub issue rongardF#72 by allowing users to specify the timezone for the datetime index in the returned DataFrame.

Changes:

  • Add timezone parameter to get_hist() method
  • Add _get_timezone_object() helper function for timezone resolution
  • Modify __create_df() to convert timestamps to specified timezone
  • Support both zoneinfo (Python 3.9+) and pytz as fallback
  • Add TV_TIMEZONE environment variable support
  • Maintain backward compatibility (no timezone = local system time)

Timezone priority: parameter > TV_TIMEZONE env var > local system

Examples:

  • timezone='UTC' returns UTC timestamps
  • timezone='America/New_York' returns EST/EDT timestamps
  • No timezone = local system time (backward compatible)

Tests: Added 15 new tests in TestTimezoneFeature class

  • Timezone object creation tests
  • Conversion accuracy tests (UTC, EST)
  • Environment variable priority tests
  • Invalid timezone error tests

Documentation updated in README.md and CLAUDE.md

Addresses GitHub issue rongardF#72 by allowing users to specify the timezone
for the datetime index in the returned DataFrame.

Changes:
- Add `timezone` parameter to get_hist() method
- Add _get_timezone_object() helper function for timezone resolution
- Modify __create_df() to convert timestamps to specified timezone
- Support both zoneinfo (Python 3.9+) and pytz as fallback
- Add TV_TIMEZONE environment variable support
- Maintain backward compatibility (no timezone = local system time)

Timezone priority: parameter > TV_TIMEZONE env var > local system

Examples:
- timezone='UTC' returns UTC timestamps
- timezone='America/New_York' returns EST/EDT timestamps
- No timezone = local system time (backward compatible)

Tests: Added 15 new tests in TestTimezoneFeature class
- Timezone object creation tests
- Conversion accuracy tests (UTC, EST)
- Environment variable priority tests
- Invalid timezone error tests

Documentation updated in README.md and CLAUDE.md
@semoi semoi merged commit b6349bf into main Nov 23, 2025
2 of 26 checks passed
@semoi semoi deleted the claude/add-timeframe-parameter-01LRVJAbqPS6sgaWdRvSerKq branch November 23, 2025 22:32
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.

3 participants