String Date Controller

A Python module for string date manipulation and formatting operations.

Features

• Date shifting: Easily shift dates forward or backward
• Date formatting: Convert dates between different formats
• Date cropping: Crop dates to specific time periods
• Date generation: Generate date sequences and ranges
• Date extraction: Extract dates from file names and folders
• Historical dates collection: Dynamically collect reference dates for timeseries analysis

Version History

v0.2.7 (2025-06-17)

• Added symmetrical date pair output function to historical_dates_collector
• Enhanced get_all_data_historical_date_pairs for consistent data structure
• Improved data access patterns for time series analysis

v0.2.6 (2025-06-15)

• Renamed functions in yearly_dates_collector for better clarity and consistency
• Changed from YTD terminology to yearly for more accurate representation
• Improved function naming conventions across the module
• Improved function naming conventions across the module

v0.2.5 (2025-06-10)

• Standardized date pair data output structures across modules
• Improved consistency in date pair dictionary mapping
• Enhanced data access patterns for time series analysis
• Enhanced data access patterns for time series analysis

v0.2.4 (2025-06-07)

• Improved data structure of get_all_data_ytd_date_pairs function in yearly_dates_collector
• Changed return type from List[Dict] to Dict[str, Tuple] for more efficient data access
• Enhanced usability for year-based date pair lookups
• Enhanced usability for year-based date pair lookups

v0.2.3 (2025-06-04)

• Added yearly_dates_collector module for YTD date pair operations
• Implemented functions to get YTD date pairs based on reference date or specific year
• Optimized get_year_first_date_simple function for better performance
• Added support for retrieving all existing years from date list

v0.2.2 (2025-06-04)

• Added get_last_date_of_year function to date_shifter module
• Enhanced date manipulation capabilities for year-end operations

v0.2.1 (2025-06-03)

• Added monthly date pairs collection for time series analysis
• Implemented functions to get month-end dates and their previous month-end dates
• Added support for nested dictionary structure for year/month organization
• Included month name mapping constants

v0.2.0 (2025-06-02)

• Major refactoring of historical dates collection functionality
• Improved logging configuration for better application integration
• Added functional approach using reduce for combining historical dates
• Enhanced month filtering to focus on 1, 3, 6 month periods
• Renamed functions for better clarity and consistency

v0.1.10 (2025-06-02)

• Fixed parameter order in historical date functions
• Enhanced readability of output keys (YTD, Since Inception)
• Fixed function call parameter alignment

v0.1.9 (2025-06-02)

• Improved API flexibility by making date_ref parameter optional with default value
• Standardized parameter order across historical date collection functions

v0.1.8 (2025-06-02)

• Added historical dates collection functionality for timeseries analysis
• Implemented functions to dynamically collect monthly, yearly, YTD, and inception dates

v0.1.6 (2025-04-23)

• Fixed dependency version format in requirements.txt

v0.1.5 (2025-04-23)

• Fixed package deployment issues

v0.1.4 (2025-04-23)

• Added file folder date extraction functionality
• Improved type handling in date generation functions
• Fixed bugs in date range generation
• Standardized naming conventions (using 'nondashed' consistently)

Installation

pip install string-date-controller

Usage

from string_date_controller import date_shifter, date_formatter, date_cropper

# Example usage will be added soon

Requirements

• Python >= 3.11
• shining_pebbles

License

MIT License

Author

June Young Park
AI Management Development Team Lead & Quant Strategist at LIFE Asset Management

LIFE Asset Management is a hedge fund management firm that integrates value investing and engagement strategies with quantitative approaches and financial technology, headquartered in Seoul, South Korea.

Contact

• Email: juneyoungpaak@gmail.com
• Location: TWO IFC, Yeouido, Seoul