{"id":31760427,"url":"https://github.com/managedkaos/special-date-calculator","last_synced_at":"2025-10-09T21:29:26.638Z","repository":{"id":291664856,"uuid":"978368464","full_name":"managedkaos/special-date-calculator","owner":"managedkaos","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-05T22:22:14.000Z","size":498,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-11T08:45:54.831Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"replit.com/@managedkaos/DateMultiplier","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/managedkaos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-05T22:01:48.000Z","updated_at":"2025-05-05T22:22:18.000Z","dependencies_parsed_at":"2025-05-05T23:23:20.088Z","dependency_job_id":"1766916a-0bf2-4f4d-b8ae-e286cc008694","html_url":"https://github.com/managedkaos/special-date-calculator","commit_stats":null,"previous_names":["managedkaos/special-date-calculator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/managedkaos/special-date-calculator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/managedkaos%2Fspecial-date-calculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/managedkaos%2Fspecial-date-calculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/managedkaos%2Fspecial-date-calculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/managedkaos%2Fspecial-date-calculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/managedkaos","download_url":"https://codeload.github.com/managedkaos/special-date-calculator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/managedkaos%2Fspecial-date-calculator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002049,"owners_count":26083285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-09T21:29:25.261Z","updated_at":"2025-10-09T21:29:26.630Z","avatar_url":"https://github.com/managedkaos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Special Date Calculator\n\nThis application identifies \"special dates\" where the product of the month and day equals the last two digits of the year. For example, May 5, 2025 is a special date because 5 × 5 = 25 (the last two digits of 2025).\n\n## Features\n\n- Command-line interface with flexible date range inputs\n- Web interface with user-friendly controls\n- Calculates and displays special dates in a formatted table\n- Shows statistics of date occurrences by decade\n- Validates input and handles edge cases\n\n## Requirements\n\n- Python 3.6 or higher\n- Flask (for web interface)\n\n## Installation\n\n1. Clone this repository:\n   ```\n   git clone https://github.com/yourusername/special-date-calculator.git\n   cd special-date-calculator\n   ```\n\n2. Install the required dependencies:\n   ```\n   pip install flask\n   ```\n\n## Usage\n\n### Command-line Interface\n\nRun the script with optional arguments:\n\n```\npython special_date_calculator.py [--start START_YEAR] [--end END_YEAR] [--current-date]\n```\n\nArguments:\n- `--start`: Starting year for calculation (default: current year)\n- `--end`: Ending year for calculation (default: 2100)\n- `--current-date`: Include current date in results if it matches criteria\n\nExamples:\n```\n# Calculate special dates from current year to 2100\npython special_date_calculator.py\n\n# Calculate special dates from 2023 to 2030\npython special_date_calculator.py --start 2023 --end 2030\n\n# Calculate special dates for a specific year\npython special_date_calculator.py --start 2025 --end 2025\n```\n\n### Web Interface\n\nRun the Flask web application:\n\n```\npython app.py\n```\n\nThen open a web browser and navigate to:\n```\nhttp://localhost:5000\n```\n\nThe web interface allows you to:\n1. Enter a start year and end year\n2. View results in a nicely formatted table\n3. See decade statistics for the date range\n\n## How It Works\n\nThe algorithm works as follows:\n\n1. For each year in the specified range:\n   - Extract the last two digits of the year\n   - For each month (1-12):\n     - Check if the last two digits are divisible by the month\n     - If divisible, calculate the day (last two digits ÷ month)\n     - Verify if the day is valid for that month (accounting for leap years)\n     - If valid, add to the list of special dates\n\n2. Display the results with appropriate formatting\n\n## Example Output\n\nThe application displays special dates in a table format:\n\n```\nSpecial dates where month × day = last two digits of year (from 2025 to 2030):\n----------------------------------------------------------------------\nDate                 Calculation          Result\n-------------------- -------------------- ----------\nJanuary 25, 2025     1 × 25               25\nMay 5, 2025          5 × 5                25\nJanuary 26, 2026     1 × 26               26\nFebruary 13, 2026    2 × 13               26\n...\n```\n\n## License\n\nMIT License - feel free to use and modify this code for your own projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanagedkaos%2Fspecial-date-calculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanagedkaos%2Fspecial-date-calculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanagedkaos%2Fspecial-date-calculator/lists"}