> For the complete documentation index, see [llms.txt](https://apidocs.lwolf.com/doc/spacio-api/llms.txt)

# Date & Time Handling

## 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
```python
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:
```json
{
  "session_id": "oh_123",
  "start_time": "2024-02-10T14:00:00Z",
  "end_time": "2024-02-10T16:00:00Z"
}
```