Skip to main content

pytimeparse: time expression parser

Travis CI build status Test code coverage Latest Version

Copyright (c) 2014 Will Roberts <wildwilhelm@gmail.com>

Licensed under the MIT License (see source file timeparse.py for details).

A small Python library to parse various kinds of time expressions, inspired by this StackOverflow question.

The single function pytimeparse.timeparse.timeparse defined in the library (also available as pytimeparse.parse) parses time expressions like the following:

  • 32m

  • 2h32m

  • 3d2h32m

  • 1w3d2h32m

  • 1w 3d 2h 32m

  • 1 w 3 d 2 h 32 m

  • 4:13

  • 4:13:02

  • 4:13:02.266

  • 2:04:13:02.266

  • 2 days, 4:13:02 (uptime format)

  • 2 days, 4:13:02.266

  • 5hr34m56s

  • 5 hours, 34 minutes, 56 seconds

  • 5 hrs, 34 mins, 56 secs

  • 2 days, 5 hours, 34 minutes, 56 seconds

  • 1.2 m

  • 1.2 min

  • 1.2 mins

  • 1.2 minute

  • 1.2 minutes

  • 172 hours

  • 172 hr

  • 172 h

  • 172 hrs

  • 172 hour

  • 1.24 days

  • 5 d

  • 5 day

  • 5 days

  • 5.6 wk

  • 5.6 week

  • 5.6 weeks

It returns the time as a number of seconds (an integer value if possible, otherwise a floating-point number):

>>> from pytimeparse import parse
>>> parse('1.2 minutes')
72

A number of seconds can be converted back into a string using the datetime module in the standard library, as noted in this other StackOverflow question:

>>> from pytimeparse import parse
>>> import datetime
>>> parse('1 day, 14:20:16')
138016
>>> str(datetime.timedelta(seconds=138016))
'1 day, 14:20:16'

Future work

  1. Give the user more flexibility over which characters to use as separators between fields in a time expression (e.g., + might be useful).

  2. Internationalisation?

  3. Wow, https://github.com/bear/parsedatetime .

Metadata

Release files for pytimeparse 1.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytimeparse 1.1.5
File Size Uploaded Provenance Actions
pytimeparse-1.1.5.tar.gz 9.2 kB Without provenance Details for pytimeparse-1.1.5.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for pytimeparse 1.1.5
File Interpreter ABI Platform Actions
pytimeparse-1.1.5-py3-none-any.whl Python 3 none any Details for pytimeparse-1.1.5-py3-none-any.whl
pytimeparse-1.1.5-py2-none-any.whl Python 2 none any Details for pytimeparse-1.1.5-py2-none-any.whl

Total release size: 28.9 kB

Release files / pytimeparse-1.1.5.tar.gz

Download URL pytimeparse-1.1.5.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9addbd29ae638e610a78a3cb50371f2091938de89c1ab61fa9cde7556a18b207
BLAKE2b-256 checksum
How to use checksums
b4d0ed98e65b376771fedcaebe4639c9348f92a9c82f156f2db0d915ae3a69a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pytimeparse-1.1.5-py3-none-any.whl

Download URL pytimeparse-1.1.5-py3-none-any.whl
Size 9.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0fbd816de24a1d1e1d97ed4e27377ee5728c37bfd9cadca865ec07996619f5c2
BLAKE2b-256 checksum
How to use checksums
4da0135c57bc0a2544ca06f47eee57395dea69cde67874deaa1c7d06cb4455a0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pytimeparse-1.1.5-py2-none-any.whl

Download URL pytimeparse-1.1.5-py2-none-any.whl
Size 9.9 kB
Tags Python 2
SHA-256 checksum
How to use checksums
8ab206d27665befbe659473937b8c1b4cf3fb584037a0fd2134723bd0f3c827e
BLAKE2b-256 checksum
How to use checksums
525bb4459181ddc305ea8baf0899ff6c1063e7b9a07541a6ea8e33312ab633a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for pytimeparse 1.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page