Package: hun-date-parser
Hungarian Date ParserA tool for extracting datetime intervals from Hungarian sentences and turning datetime objects into Hungarian text.Install and try the package withpip install hun-date-parserUsageIf not specified otherwise, relative dates (eg.: tomorrow, next week, etc.) are calculated relative to the current datetime, at the time when the function is called. Thenowparameter can be used for parsing relative datetimes relative to any timestamp other than the current time.fromhun_date_parserimporttext2datetimefromdatetimeimportdatetimetext2datetime('találkozzunk jövő kedd délután!',now=datetime(2020,12,27))# [{'start_date' datetime.datetime(2020, 12, 29, 17, 59, 59)}]text2datetime('találkozzunk jövő héten szombaton háromnegyed nyolc előtt két perccel',now=datetime(2020,12,27))# [{'start_date' datetime.datetime(2021, 1, 2, 7, 43, 59)}]text2datetime('találkozzunk jövő héten szombaton este háromnegyed nyolc előtt két perccel',now=datetime(2020,12,27))# [{'start_date' datetime.datetime(2021, 1, 2, 19, 43, 59)}]The date parser is also capable of parsing explicit intervals from the text even when only one side of the interval is specified.fromhun_date_parserimporttext2datetimefromdatetimeimportdatetimetext2datetime('2020 decemberétől 2021 januárig',now=datetime(2020,12,27))# [{'start_date' datetime.datetime(2021, 1, 31, 23, 59, 59)}]text2datetime('2021 januárig',now=datetime(2020,12,27))# [{'start_date' datetime.datetime(2021, 1, 31, 23, 59, 59)}]Supported formatsOur parser implements a rule-based strategy to interpret a diverse array of date and time formats, utilizing grammatical inflection to parse intervals.The following formats are currently supported:Date Formats:ISO Standard Dates: dates formatted to the ISO 8601 standard.Examples:2020-01-15,2020-12-30-án,2020.12.29.Named Months: months indicated by name, optionally with day numbers and/or year. Day numbers may be expressed lexically.Examples:tavaly február,2020 február 3,jövő március,jövő február 12-én,március elsején.Relative Time References: relative days, weeks, months, or years.Examples:tegnap,ma,holnap,idén,tavaly,múlt héten,a múlt hónapban,idei események.Named Days of the Week: references to specific weekdays, accounting for past, present, and future contexts.Examples:múlt vasárnap,kedden,ezen a heten hétfőn,jövő héten szerdán.Counted Time Frames: expressions indicating a number of days or weeks ago or in the future.Examples:1 héttel ezelőtt,6 nappal ezelőtt,5 nap múlva.Historical Periods: periods up to the present date, defined by days, weeks, months, or years.Examples:az előző két hétben,az előző két évi adatok,az előző 10 nap eredménye.Time Formats:Digital Clock Format: time expressed in digital clock notation.Examples45`.Natural Language Time: time described in conversational terms.Examples:este fél 8,reggel nyolc előtt hat perccel,nyolc óra nyolc perckor,20 óra 49 perckor,este negyed 8 előtt 6 perccel.Abbreviated Time Formats: certain abbreviated forms of time expression.Examples:16h-kor.Interval Formats:Inflection-Implied Ranges: intervals detected through grammatical inflections, indicating a start and end point.Examples:február 13-tól 17-ig,keddtől péntekig,januártól februárig,2020-10-12-től 2020-11-01-ig.Open-Ended Intervals: expressions where the start or end of the interval is unspecified, using inflections to imply boundaries.Examples:keddtől,február elsejéig.Setting search scope in case of ambiguous inputFor the functiontext2datetimethe parametersearch_scopeis used to inform what is the desired time interval to parse the inputs.The default valueSearchScopes.NOT_RESTRICTEDdoesn't restrict the scope of the search.i.e.: when Tuesday is parsed the date for the Tuesday on the given week is going to be returned, not considering whether that given date is in the past or the futureTo prefer future dates in case of ambiguity, use the valueSearchScopes.FUTURE_DAYIn this case, when Tuesday is parsed, the function will return the closest Tuesday in the future, not necessarily the current week's Tuesday.Similarly to search in the future, nudging the library to prefer past dates is possible with the valueSearchScopes.PAST_SEARCHFor instance, given a scenario when May is parsed by the function, with this setting, if this year's May is still in the future, last year's May will be returned.Please note, when there's no ambiguity, the function can still return future/past dates, even when a different preference is specified.An example:fromhun_date_parserimporttext2datetimefromdatetimeimportdatetimefromhun_date_parser.utilsimportSearchScopestext2datetime('augusztus',now=datetime(2023,6,7),search_scope=SearchScopes.PAST_SEARCH)# [{'start_date': datetime.datetime(2022, 8, 1, 0, 0),#   'end_date': datetime.datetime(2022, 8, 31, 23, 59, 59)}]text2datetime('péntek',now=datetime(2023,6,7),search_scope=SearchScopes.PAST_SEARCH)# [{'start_date': datetime.datetime(2023, 6, 2, 0, 0),#   'end_date': datetime.datetime(2023, 6, 2, 23, 59, 59)}]text2datetime('péntek',now=datetime(2023,6,7),search_scope=SearchScopes.NOT_RESTRICTED)# [{'start_date': datetime.datetime(2023, 6, 9, 0, 0),#   'end_date': datetime.datetime(2023, 6, 9, 23, 59, 59)}]Datetime to textThe library is also capable of turning datetime objects into their Hungarian text representation.fromhun_date_parserimportdatetime2textfromdatetimeimportdatetimedatetime2text(datetime(2020,12,20,18,34),now=datetime(2020,12,27),time_precision=2)# {'dates': ['múlt héten vasárnap', '2020 december 20'],#  'times'34', 'este hat óra harmincnégy perc', 'este fél 7 után 4 perccel']}LicenseThis project is licensed underMITlicense. Feel free to use it in your own projects.ContributeAny help or feedback in further developing the library is welcome!