timezone-santiago

What problem does it solve?

The skill ensures that every user-facing date and time in the application reliably reflects local Chile time (America/Santiago) including daylight saving transitions, preventing reporting errors, misplaced sales by day, and confusion in tickets, exports and attendance records while keeping internal storage in UTC.

Core Features & Use Cases

• Centralized TIMEZONE constant to avoid scattered timezone strings and accidental misuse.
• Formatting helpers for full datetime, date-only, and time-only displays using Intl.DateTimeFormat or date-fns-tz where available.
• Database guidance to store timestamps as TIMESTAMPTZ in UTC and convert with AT TIME ZONE for grouping, ranges and TimeScaleDB continuous aggregates.
• Deployment and environment recommendations (TZ env, Docker, Vercel) plus a validation checklist to verify UI, tickets, exports, logs and reports use Santiago time.
• Use Case: Generate daily sales reports and POS receipts that correctly group late-night Chile sales into the intended Chilean date despite UTC offsets.

Quick Start

Use the timezone-santiago skill to convert and format all display dates to America/Santiago before rendering user interfaces, tickets, or exported files.