system_date_time_change 1.0.0

system_date_time_change: ^1.0.0 copied to clipboard

Initial Release

New Features #

• Time Difference Calculation: Added timeDifferenceMs to show the difference between current time and expected time
• Device Uptime Tracking: Added deviceUptimeMs to track device uptime since last boot
• Duration Helpers: Added timeDifference and deviceUptime Duration getters for easy formatting

Features #

• ✅ Real-time detection of system date/time changes
• ✅ Stream-based event notifications for time changes
• ✅ Manual polling support with checkDateTimeStatus()
• ✅ Detect manual time modifications
• ✅ Identify timezone mismatches
• ✅ Check auto-time settings status (where available)
• ✅ Cross-platform support:
  • Android (BroadcastReceiver-based)
  • iOS (Notification-based)
  • macOS (Notification-based)
  • Windows (WM_TIMECHANGE message)
  • Linux (Polling-based)
  • Web (Polling-based)

Platform Capabilities #

• Android: Full support with BroadcastReceivers and Settings API
• iOS: Real-time notifications (limited auto-time detection)
• macOS: Real-time notifications with NSSystemClockDidChange
• Windows: Native WM_TIMECHANGE message handling
• Linux: Polling mechanism with timezone file monitoring
• Web: Basic polling-based detection

API #

• checkDateTimeStatus() - Get current date/time status
• onDateTimeChanged - Stream of date/time change events
• startListening() - Start monitoring time changes
• stopListening() - Stop monitoring time changes

Models #

• DateTimeChangeEvent - Event data for time changes
• DateTimeChangeStatus - Complete status information

Notes #

• Uses native platform APIs only (no external dependencies)
• Respects platform security and privacy restrictions
• Example app included with comprehensive UI