KiviCare’s multi-timezone system enables globally distributed clinics — with doctors, patients, staff, and administrators across different time zones — to manage appointments without ambiguity or scheduling conflicts.
This feature ensures:
Appointment times are never ambiguous
Doctors manage schedules in their own local time
Patients book appointments in their own local time
All time calculations remain accurate across regions
Daylight Saving Time (DST) changes are handled correctly
The system eliminates confusion in global healthcare operations.
2. System Architecture Overview
KiviCare uses a standardized universal time architecture to ensure consistency and accuracy.
Core Principle
All appointment records are stored in a neutral universal time reference.
Each user sees times displayed according to their configured timezone.
Two-Layer Timezone Model
Layer
Purpose
Source Timezone
Doctor’s timezone used for schedule definition and slot generation
Target Timezone
Viewer’s timezone used for displaying appointment times
This model guarantees:
Accurate cross-region booking
No overlap conflicts
No cross-midnight miscalculations
No daylight saving discrepancies
3. Timezone Ownership & Roles
3.1 Doctor Timezone
Each doctor profile contains an assigned timezone.
This timezone determines:
Working hours
Session schedules
Slot availability
Leave and holiday evaluation
Conflict detection
If not configured, the system uses the clinic’s default timezone.
3.2 Patient Timezone
Each patient can configure their personal timezone.
This timezone controls:
Slot display during booking
Appointment confirmation time
Appointment history view
If not configured, the system defaults to the clinic timezone.
3.3 Clinic (WordPress) Timezone
The clinic’s primary timezone acts as:
System fallback
Administrative reference timezone
Email notification timezone
Fallback Hierarchy
User Timezone ↓ Clinic Timezone ↓ Universal Time
4. User Profile Configuration
Doctor Profile
Dedicated timezone selector
Global IANA timezone support
Editable at any time
Automatically applied to scheduling logic
Patient Profile
Self-configurable timezone
Global timezone support
Editable anytime
Applied to booking and display views
Receptionist & Clinic Administrator
Personal timezone setting
Used for dashboard appointment displays
Does not affect slot generation
5. Booking & Slot Generation Logic
The booking system ensures accurate conversion across timezones while maintaining schedule integrity.
Slot Generation Process
Doctor timezone is resolved
Selected date is interpreted in doctor’s timezone
Doctor sessions are loaded
Existing appointments are checked
Booked slots are blocked
Available slots are converted to viewer’s timezone
Result
The doctor sees appointment time in their local time
The patient sees the same appointment in their local time
The system maintains one universal reference internally
This guarantees full consistency.
6. Frontend Booking Experience
The booking interface includes:
Automatic browser timezone detection
Searchable timezone selector
UTC offset indicators
Real-time slot conversion
Clear timezone labeling during booking
Timezone confirmation at final step
Patients always know which timezone they are booking in.
7. Dashboard Appointment Display Rules
User Role
Display Timezone
Patient
Patient’s saved timezone
Doctor
Clinic timezone
Administrator
Clinic timezone
Receptionist
Clinic timezone
Each dashboard clearly displays:
“Showing times in: [Timezone]”
This avoids operational confusion.
8. Appointment Storage Strategy
Universal Time Standardization
All appointments are normalized into a universal time reference for:
Conflict detection
Overlap prevention
Reporting accuracy
Data consistency
Timezone Stamping
Each appointment permanently records:
The timezone in which it was booked
This ensures:
Historical accuracy
Audit clarity
Legal traceability
9. Appointment Viewing Experience
Appointment List View
Times are converted to the viewer’s timezone
Timezone label is visible
Consistent formatting applied
Appointment Detail View
Appointment time reflects viewer’s configured timezone
No ambiguity between users
10. Leave & Holiday Handling
Full-Day Leave
Evaluated entirely in doctor’s local timezone
Entire calendar day blocked for booking
Partial Leave
Leave hours interpreted in the correct timezone
Overlapping slots automatically disabled
This prevents booking conflicts.
11. Email Notification Behavior
All automated emails use:
Clinic’s configured timezone
Clinic date/time format
This ensures consistent official communication.
12. Timezone Validation & Standards
Supported Formats
Official IANA timezone names
Standard UTC offset formats
Invalid Values
Automatically rejected
Safe fallback applied
System stability maintained
Conclusion
The KiviCare Multi-Timezone System provides a robust, enterprise-grade scheduling architecture built for modern global healthcare operations.
It ensures:
Accurate appointment management
Clear timezone ownership
Consistent communication
Scalable international deployment
This feature is fully integrated into both Lite and Pro versions of KiviCare and requires no additional configuration beyond timezone setup.
