Parse an Unstructured Date/Time String in Python

2 min readDec 3, 2020


Email and instant messaging were created to be a simple and streamlined way for people to communicate important information such as meeting times and deadlines. However, because of their often-casual style, collecting and logging that information can be difficult as it may not be easily read by a computer program. The following API will process and parse unstructured Date/Time information using Natural Language Processing into its standardized form. For example, an email setting up a meeting for “tomorrow at 3pm” will have this information restructured in “yyyy-mm-dd” and “00:00:00” format.

You can use this API by running this command to install the SDK:

pip install cloudmersive-validate-api-client

Then, you can call the function:

from __future__ import print_function
import time
import cloudmersive_validate_api_client
from import ApiException
from pprint import pprint
# Configure API key authorization: Apikey
configuration = cloudmersive_validate_api_client.Configuration()
configuration.api_key['Apikey'] = 'YOUR_API_KEY'
# create an instance of the API class
api_instance = cloudmersive_validate_api_client.DateTimeApi(cloudmersive_validate_api_client.ApiClient(configuration))
input = cloudmersive_validate_api_client.DateTimeNaturalLanguageParseRequest() # DateTimeNaturalLanguageParseRequest | Input request
# Parses a free-form natural language date and time string into a date and time
api_response = api_instance.date_time_parse_natural_language_date_time(input)
except ApiException as e:
print("Exception when calling DateTimeApi->date_time_parse_natural_language_date_time: %s\n" % e)

This will return the parsed date result, year, month, day, hour, minute, second, and day of the week. You can retrieve the API Key from the Cloudmersive website at no cost and with no commitment. This will provide you with 800 monthly calls across our library of APIs.




There’s an API for that. Cloudmersive is a leader in Highly Scalable Cloud APIs.