Date & Time Handling
UTC Standard
All timestamps are in UTC (Coordinated Universal Time). Always convert to user's local timezone when displaying.
Supported Formats
Date Format (date)
- ISO 8601: YYYY-MM-DD
- Example: 2024-01-15
DateTime Format (date-time)
- ISO 8601 with timezone: YYYY-MM-DDTHH:MM:SSZ
- Example: 2024-01-15T14:30:00Z
Timezone Examples
from datetime import datetime, timezone
import pytz
# Parse UTC timestamp from API
utc_time = datetime.fromisoformat('2024-01-15T14:30:00Z')
# Convert to user timezone
pacific = pytz.timezone('US/Pacific')
local_time = utc_time.astimezone(pacific)
print(local_time) # 2024-01-15 06:30:00-08:00
# Send date to API
today = datetime.now(timezone.utc).date().isoformat()
data = {'start_date': today, ...}
Open House DateTime Example
Open house sessions use full datetime:
{
"session_id": "oh_123",
"start_time": "2024-02-10T14:00:00Z",
"end_time": "2024-02-10T16:00:00Z"
}