Function to Notify Late Arrival

In this section, we will create a Python function that you can use to notify about a late arrival. The function will take a date and time as input and print an appropriate message.

Function Overview

Purpose

The purpose of the function is to send a notification indicating that you will be late for a scheduled event.

Parameters

• arrival_time (str): A string representing the expected arrival time in ISO format (YYYY-MM-DD HH:MM).
• current_time (str): A string representing the current time in ISO format (YYYY-MM-DD HH:MM).

Return Type

• Returns a message string indicating whether you will be late or on time.

Exceptions

• Raises ValueError if the time strings do not match the expected format.

Code Implementation

from datetime import datetime

def notify_late(arrival_time: str, current_time: str) -> str:
    """
    Notify whether you will be late to a scheduled event.

    Parameters:
    arrival_time (str): Expected arrival time in ISO format (YYYY-MM-DD HH:MM).
    current_time (str): Current time in ISO format (YYYY-MM-DD HH:MM).

    Returns:
    str: A message indicating whether you will be late or on time.

    Raises:
    ValueError: If the time strings are not in the correct format.
    """
    
    # Define the expected format for the time string
    time_format = "%Y-%m-%d %H:%M"
    
    try:
        # Parse the arrival and current times
        arrival_dt = datetime.strptime(arrival_time, time_format)
        current_dt = datetime.strptime(current_time, time_format)
    
    except ValueError:
        raise ValueError("Time must be in 'YYYY-MM-DD HH:MM' format.")
    
    # Determine if the current time is later than the arrival time
    if current_dt > arrival_dt:
        return "You will be late."
    else:
        return "You will arrive on time."

Code Usage Example

Here’s how you can use this function in a real-world scenario:

# Example Usage
arrival_time = "2023-10-12 14:30"
current_time = "2023-10-12 14:45"

message = notify_late(arrival_time, current_time)
print(message)  # Output: You will be late.

Summary

In this code, we:

1. Implemented a function that takes expected arrival and current times.
2. Included robust error handling for time format validation.
3. Demonstrated usage with a practical example.

This code adheres to best practices in Python programming, ensuring clarity, maintainability, and scalability.

For further learning on related topics, consider exploring courses on the Enterprise DNA Platform, which offers comprehensive training in data science and analysis.