General Greedy Date Time Parser

0.1.6 verified Sat May 09 auth: no python

A Python library for parsing natural language date/time strings into datetime objects. Version 0.1.6 is current; initial release with frequent updates.

pip install gggdtparser

Common errors

error ModuleNotFoundError: No module named 'gggdtparser' ↓

cause Library not installed or virtual environment not activated.

fix

Run pip install gggdtparser in your environment.

error TypeError: parse_datetime() missing 1 required positional argument: 'string' ↓

cause Called without the string argument.

fix

Use parse_datetime('some date string').

error parse_datetime('2024-03-15') returns None ↓

cause Input format '%Y-%m-%d' not supported; expects Chinese-style dates.

fix

Convert to Chinese format like '2024年3月15日' or use default_date for relative terms.

Warnings

deprecated The import `from gggdtparser import GggdtParser` is deprecated in favor of top-level `parse_datetime`. ↓

fix Use `from gggdtparser import parse_datetime` instead.

gotcha Library is optimized for Chinese date/time patterns; non-Chinese strings may fail or return incorrect results. ↓

fix Ensure input strings follow Chinese date/time conventions (e.g., YYYY年MM月DD日).

gotcha Relative date parsing (like '下周五') requires a `default_date` parameter; without it, it may use today's date or raise an error. ↓

fix Always provide `default_date` as a string in YYYY-MM-DD format when using relative terms.

Imports

parse_datetime
```
from gggdtparser import parse_datetime
```
Primary function for parsing.

Quickstart

Basic usage: parse a Chinese date string and a relative date.

from gggdtparser import parse_datetime

result = parse_datetime("2024年3月15日")
print(result)  # 2024-03-15 00:00:00

# Or with default date
result2 = parse_datetime("下周五", default_date="2024-03-15")
print(result2)  # 2024-03-22 00:00:00