{"id":27797,"library":"gggdtparser","title":"General Greedy Date Time Parser","description":"A Python library for parsing natural language date/time strings into datetime objects. Version 0.1.6 is current; initial release with frequent updates.","status":"active","version":"0.1.6","language":"python","source_language":"en","source_url":"https://github.com/kusen-alpha/gggdtparser","tags":["date-parsing","time-parsing","natural-language","chinese","datetime"],"install":[{"cmd":"pip install gggdtparser","lang":"bash","label":"Default install"}],"dependencies":[],"imports":[{"note":"Primary function for parsing.","wrong":null,"symbol":"parse_datetime","correct":"from gggdtparser import parse_datetime"}],"quickstart":{"code":"from gggdtparser import parse_datetime\n\nresult = parse_datetime(\"2024年3月15日\")\nprint(result)  # 2024-03-15 00:00:00\n\n# Or with default date\nresult2 = parse_datetime(\"下周五\", default_date=\"2024-03-15\")\nprint(result2)  # 2024-03-22 00:00:00\n","lang":"python","description":"Basic usage: parse a Chinese date string and a relative date."},"warnings":[{"fix":"Use `from gggdtparser import parse_datetime` instead.","message":"The import `from gggdtparser import GggdtParser` is deprecated in favor of top-level `parse_datetime`.","severity":"deprecated","affected_versions":"<0.1.5"},{"fix":"Ensure input strings follow Chinese date/time conventions (e.g., YYYY年MM月DD日).","message":"Library is optimized for Chinese date/time patterns; non-Chinese strings may fail or return incorrect results.","severity":"gotcha","affected_versions":"all"},{"fix":"Always provide `default_date` as a string in YYYY-MM-DD format when using relative terms.","message":"Relative date parsing (like '下周五') requires a `default_date` parameter; without it, it may use today's date or raise an error.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install gggdtparser` in your environment.","cause":"Library not installed or virtual environment not activated.","error":"ModuleNotFoundError: No module named 'gggdtparser'"},{"fix":"Use `parse_datetime('some date string')`.","cause":"Called without the string argument.","error":"TypeError: parse_datetime() missing 1 required positional argument: 'string'"},{"fix":"Convert to Chinese format like '2024年3月15日' or use `default_date` for relative terms.","cause":"Input format '%Y-%m-%d' not supported; expects Chinese-style dates.","error":"parse_datetime('2024-03-15') returns None"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}