datetime-timezone-correctness

Enforce UTC storage and IANA-compliant timezone conversions for datetime processing.

9|3|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill datetime-timezone-correctness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: datetime-timezone-correctness
Source: https://github.com/Sir-chawakorn/sanook-cli/tree/main/skills/datetime-timezone-correctness
Command: npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill datetime-timezone-correctness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves critical errors in timestamp handling, such as off-by-one-hour bugs during daylight savings transitions, incorrect date calculations across timezones, and failures in recurring event scheduling.

Core Features & Use Cases

  • Standardized Time Handling: Enforces the use of absolute UTC instants for storage and IANA timezone databases for local display.
  • DST & Boundary Logic: Provides robust patterns for handling spring-forward gaps, fall-back overlaps, and leap-day arithmetic.
  • Use Case: If your application is firing scheduled jobs at the wrong time after a clock change or displaying incorrect dates for global users, this skill provides the architectural patterns to fix the underlying logic.

Quick Start

Use the datetime-timezone-correctness skill to audit the codebase for naive datetime usage and implement IANA-compliant timezone conversions.

Frequently Asked Questions about datetime-timezone-correctness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix scheduled jobs firing at the wrong time after a daylight savings transition?

To fix scheduled jobs firing incorrectly after daylight savings transitions, enforce UTC-based timestamp storage and apply IANA-compliant timezone databases for local display conversions. This standardizes time processing and prevents off-by-one-hour bugs during clock changes.

What is the best way to handle timezone conversion for global users without date calculation errors?

The best way to handle timezone conversion for global users without date calculation errors is to store absolute UTC instants and apply IANA timezone database rules for regional display. This ensures accurate date calculations across different timezones.

How do I manage recurring event scheduling across timezones with daylight savings overlaps?

Managing recurring event scheduling across timezones with daylight savings overlaps requires strict adherence to monotonic clock sources for durations and explicit offset-aware parsing for all timestamps. This handles spring-forward gaps and fall-back overlaps robustly.

Does my application need UTC storage to prevent leap-year arithmetic and DST boundary bugs?

Yes, your application needs UTC storage to prevent leap-year arithmetic and DST boundary bugs. Standardizing on absolute UTC instants for storage while using IANA timezones for display resolves critical temporal boundary failures and incorrect date calculations.

Why does my naive datetime usage cause incorrect dates for international users?

Naive datetime usage causes incorrect dates for international users because it lacks explicit offset-aware parsing and IANA timezone database compliance. Auditing your codebase to enforce UTC-based storage for absolute instants resolves these cross-timezone display failures.