stacks-datetime

Provide immutable DateTime arithmetic and token-based formatting for TypeScript environments.

2|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/bughq/bughq --skill stacks-datetime-bughq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacks-datetime
Source: https://github.com/bughq/bughq/tree/main/.claude/skills/stacks-datetime
Command: npx skills add https://github.com/bughq/bughq --skill stacks-datetime-bughq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the inconsistencies and mutability issues inherent in native JavaScript Date objects by providing a robust, Carbon-inspired API for date manipulation, parsing, and formatting.

Core Features & Use Cases

  • Immutable Arithmetic: Perform date calculations (add/sub days, months, years) without mutating the original object.
  • Token-based Formatting & Parsing: Easily convert dates to and from strings using intuitive tokens like YYYY-MM-DD or MMMM D, YYYY.
  • Use Case: Use this to calculate relative timeframes, such as determining the start and end of a fiscal month or comparing two timestamps for scheduling logic in a Stacks application.

Quick Start

Use the stacks-datetime skill to parse the string 2024-06-15 and add seven days to it.

Frequently Asked Questions about stacks-datetime

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

FAQPage Schema
How do I handle immutable date and time manipulation in TypeScript without external dependencies?

Immutable date and time manipulation in TypeScript is achieved by using a zero-dependency DateTime class that performs arithmetic operations like adding or subtracting days without mutating the original object.

What is the best way to parse timezone-aware dates and format them using tokens in a Stacks application?

Timezone-aware date parsing and token-based formatting are handled by a comprehensive DateTime utility that converts strings using intuitive tokens like YYYY-MM-DD, generating locale-specific outputs within the Stacks framework.

Why does mutating native JavaScript Date objects cause inconsistencies in scheduling logic?

Mutating native JavaScript Date objects causes inconsistencies because original timestamp values change during calculations, whereas an immutable, Carbon-inspired API ensures original dates remain intact during relative timeframe comparisons.

Can I perform complex date arithmetic to calculate fiscal month start and end dates in TypeScript?

Complex date arithmetic for calculating fiscal month boundaries is supported by immutable utility functions that add or subtract months and years, allowing precise scheduling logic without altering baseline timestamps.

Do I need external libraries for locale-specific date formatting in a TypeScript environment?

External libraries are not needed for locale-specific date formatting because this zero-dependency solution integrates directly with TypeScript environments to parse and generate localized date strings.

Does stacks-datetime support token-based string parsing for date conversion?

Token-based string parsing for date conversion is fully supported, allowing developers to easily parse dates from and to strings using intuitive formatting tokens like MMMM D, YYYY within the Stacks framework.