Skip to content

Easy Date Formatter

py_simple.easy_date_formatter

easy_date_formatter is meant to simplify getting formatted dates. Built on top of the datetime module — no more memorizing strftime codes.

dd_mm_yyyy()

Returns the current date in 'DD-MM-YYYY' format.

Returns:

Name Type Description
str

Current date as 'DD-MM-YYYY' (e.g., '20-07-2026').

Example
from py_simple import dd_mm_yyyy

today = dd_mm_yyyy()  # -> "31-07-2026"
from datetime import datetime

today = datetime.now().strftime("%d-%m-%Y")

future_dd_mm_yyyy(num_days_from_now)

Returns a future date in 'DD-MM-YYYY' format.

Parameters:

Name Type Description Default
num_days_from_now int

Number of days to add to today.

required

Returns:

Name Type Description
str

Future date as 'DD-MM-YYYY'.

Example
from py_simple import future_dd_mm_yyyy

next_week = future_dd_mm_yyyy(7)
from datetime import datetime, timedelta

next_week = (datetime.now() + timedelta(days=7)).strftime(
    "%d-%m-%Y"
)

future_mm_dd_yyyy(num_days_from_now)

Returns a future date in 'MM-DD-YYYY' format.

Parameters:

Name Type Description Default
num_days_from_now int

Number of days to add to today.

required

Returns:

Name Type Description
str

Future date as 'MM-DD-YYYY'.

Example
from py_simple import future_mm_dd_yyyy

next_week = future_mm_dd_yyyy(7)
from datetime import datetime, timedelta

next_week = (datetime.now() + timedelta(days=7)).strftime(
    "%m-%d-%Y"
)

future_slash_dd_mm_yyyy(num_days_from_now)

Returns a future date in 'DD/MM/YYYY' format.

Parameters:

Name Type Description Default
num_days_from_now int

Number of days to add to today.

required

Returns:

Name Type Description
str

Future date as 'DD/MM/YYYY'.

Example
from py_simple import future_slash_dd_mm_yyyy

next_week = future_slash_dd_mm_yyyy(7)
from datetime import datetime, timedelta

next_week = (datetime.now() + timedelta(days=7)).strftime(
    "%d/%m/%Y"
)

future_slash_mm_dd_yyyy(num_days_from_now)

Returns a future date in 'MM/DD/YYYY' format.

Parameters:

Name Type Description Default
num_days_from_now int

Number of days to add to today.

required

Returns:

Name Type Description
str

Future date as 'MM/DD/YYYY'.

Example
from py_simple import future_slash_mm_dd_yyyy

next_week = future_slash_mm_dd_yyyy(7)
from datetime import datetime, timedelta

next_week = (datetime.now() + timedelta(days=7)).strftime(
    "%m/%d/%Y"
)

get_future_pretty_date(num_days_from_now)

Calculates a future date in pretty format.

Parameters:

Name Type Description Default
num_days_from_now int

Number of days to add to today.

required

Returns:

Name Type Description
str

Future date as 'Weekday, Month Day, Year'.

Example
from py_simple import get_future_pretty_date

next_week = get_future_pretty_date(7)
from datetime import datetime, timedelta

next_week = (datetime.now() + timedelta(days=7)).strftime(
    "%A, %B %d, %Y"
)

get_past_pretty_date(num_days_ago)

Calculates a date from the past in pretty format.

Parameters:

Name Type Description Default
num_days_ago int

Number of days to subtract from today.

required

Returns:

Name Type Description
str

Past date as 'Weekday, Month Day, Year'.

Example
from py_simple import get_past_pretty_date

last_week = get_past_pretty_date(7)
from datetime import datetime, timedelta

last_week = (datetime.now() - timedelta(days=7)).strftime(
    "%A, %B %d, %Y"
)

get_pretty_date()

Returns the current date in a human-friendly format.

Returns:

Name Type Description
str

Current date formatted as 'Weekday, Month Day, Year' (e.g., 'Monday, July 20, 2026').

Example
from py_simple import get_pretty_date

today = get_pretty_date()  # -> "Friday, July 31, 2026"
from datetime import datetime

today = datetime.now().strftime("%A, %B %d, %Y")

list_available_formats()

Returns the supported format names for reference.

Returns:

Type Description

list[str]: Names of every format key this module supports (e.g. 'pretty', 'dd-mm-yyyy', 'mm/dd/yyyy').

Example
from py_simple import list_available_formats

formats = list_available_formats()
# -> ['pretty', 'dd-mm-yyyy', 'mm-dd-yyyy', 'dd/mm/yyyy', 'mm/dd/yyyy']
# There's no built-in equivalent — you'd have to keep
# your own list of strftime patterns to remember them.
formats = ["%A, %B %d, %Y", "%d-%m-%Y", "%m-%d-%Y"]

mm_dd_yyyy()

Returns the current date in 'MM-DD-YYYY' format.

Returns:

Name Type Description
str

Current date as 'MM-DD-YYYY' (e.g., '07-31-2026').

Example
from py_simple import mm_dd_yyyy

today = mm_dd_yyyy()  # -> "07-31-2026"
from datetime import datetime

today = datetime.now().strftime("%m-%d-%Y")

past_dd_mm_yyyy(num_days_ago)

Returns a past date in 'DD-MM-YYYY' format.

Parameters:

Name Type Description Default
num_days_ago int

Number of days to subtract from today.

required

Returns:

Name Type Description
str

Past date as 'DD-MM-YYYY'.

Example
from py_simple import past_dd_mm_yyyy

last_week = past_dd_mm_yyyy(7)
from datetime import datetime, timedelta

last_week = (datetime.now() - timedelta(days=7)).strftime(
    "%d-%m-%Y"
)

past_mm_dd_yyyy(num_days_ago)

Returns a past date in 'MM-DD-YYYY' format.

Parameters:

Name Type Description Default
num_days_ago int

Number of days to subtract from today.

required

Returns:

Name Type Description
str

Past date as 'MM-DD-YYYY'.

Example
from py_simple import past_mm_dd_yyyy

last_week = past_mm_dd_yyyy(7)
from datetime import datetime, timedelta

last_week = (datetime.now() - timedelta(days=7)).strftime(
    "%m-%d-%Y"
)

past_slash_dd_mm_yyyy(num_days_ago)

Returns a past date in 'DD/MM/YYYY' format.

Parameters:

Name Type Description Default
num_days_ago int

Number of days to subtract from today.

required

Returns:

Name Type Description
str

Past date as 'DD/MM/YYYY'.

Example
from py_simple import past_slash_dd_mm_yyyy

last_week = past_slash_dd_mm_yyyy(7)
from datetime import datetime, timedelta

last_week = (datetime.now() - timedelta(days=7)).strftime(
    "%d/%m/%Y"
)

past_slash_mm_dd_yyyy(num_days_ago)

Returns a past date in 'MM/DD/YYYY' format.

Parameters:

Name Type Description Default
num_days_ago int

Number of days to subtract from today.

required

Returns:

Name Type Description
str

Past date as 'MM/DD/YYYY'.

Example
from py_simple import past_slash_mm_dd_yyyy

last_week = past_slash_mm_dd_yyyy(7)
from datetime import datetime, timedelta

last_week = (datetime.now() - timedelta(days=7)).strftime(
    "%m/%d/%Y"
)

slash_dd_mm_yyyy()

Returns the current date in 'DD/MM/YYYY' format.

Returns:

Name Type Description
str

Current date as 'DD/MM/YYYY' (e.g., '31/07/2026').

Example
from py_simple import slash_dd_mm_yyyy

today = slash_dd_mm_yyyy()  # -> "31/07/2026"
from datetime import datetime

today = datetime.now().strftime("%d/%m/%Y")

slash_mm_dd_yyyy()

Returns the current date in 'MM/DD/YYYY' format.

Returns:

Name Type Description
str

Current date as 'MM/DD/YYYY' (e.g., '07/31/2026').

Example
from py_simple import slash_mm_dd_yyyy

today = slash_mm_dd_yyyy()  # -> "07/31/2026"
from datetime import datetime

today = datetime.now().strftime("%m/%d/%Y")