reservation-calendar 0.0.1

A Reservation Calendar System

Reservation Calendar

This module allows you to create a week based calendar for your reservations.

For seasonal resorts, this module creates a list of weeks for 5 previous years and 10 future years. This weekly calendar is used to pick future dates based on the current reservation.

Inspired by Fun Valley Family Resort in South Fork, Colorado, USA.

How it works

At Fun Valley guests are allowed to book "their" dates for the following year at checkout. Since the resort is seasonal, opening on Memorial Day each year, the calendar slides forward and backward every 7th year. Every 7th year there are 6 weeks in May.

If you stay in a cabin on June 9th, 2023 (Friday) thru June 11th, 2023 (Monday), you can book the same DAYS for the following year. The calendar will show you the dates for the following year, June 7th, 2024 (Friday) thru June 10th, 2024 (Monday).

Since reservations are based on the day of the week in the given week of the season, the dates are calculated based on the day of the week of the current reservation.

How to use it

from reservation_calendar import ReservationCalendar

calendar = ReservationCalendar()

# Get FVRC week number and weekday number for a given date
date = datetime(2023, 6, 9)
fvrc_week_number, fvrc_weekday_number = calendar.get_fvrc(date)
print("FVRC week number:", fvrc_week_number)
print("FVRC weekday number:", fvrc_weekday_number)

# Get FVRC day name for a given date
fvrc_day_name = calendar.get_fvrc_day(date)
print("FVRC day name:", fvrc_day_name)


print(f"Future Reservation Dates for {date}:")
for year in range(2024, 2035):
  print(f"{calendar.get_reservation_start_date(date, year)}")

Output

FVRC week number: 2
FVRC weekday number: 5
FVRC day name: Friday
Future Reservation Dates for 2023-06-09:
2024-06-07
2025-06-06
2026-06-05
2027-06-11
2028-06-09
2029-06-08
2030-06-07
2031-06-06
2032-06-11
2033-06-10
2034-06-09