ISO 8601 Duration Parser & Arithmetic Workbench

ISO 8601 Duration Parser & Arithmetic Workbench | Online Free Tool | Elysia Tools

Tool usage guide

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Category: Date & Time
Input types: select, textarea, text
Output type: html
Sample coverage: 4
API ready: Yes

Overview

The ISO 8601 Duration Parser & Arithmetic Workbench allows you to inspect standard and extended ISO 8601 duration strings, evaluate calendar-accurate arithmetic expressions, sort durations by true elapsed length, and compute intervals between datetimes.

When to use

When parsing and validating standard ISO 8601 or ISO 8601-2 duration strings like P1Y2M, PT36H, or P2W3D.
When evaluating arithmetic expressions like P1Y2M + P11M - P90D against a specific calendar anchor date.
When calculating the exact ISO duration between two timestamps or sorting multiple durations by elapsed length.

How it works

1Select your target workbench mode: Parse & Inspect, Arithmetic Expression, Sort by Real Length, or Datetime Difference.
2Enter your ISO 8601 duration strings, mathematical expression, or start and end timestamps into the designated input fields.
3Specify an anchor datetime to anchor variable-length calendar components such as months and leap years.
4Inspect the parsed component breakdown, canonical ISO representation, or step-by-step arithmetic calculation table.

Use cases

Validating Temporal.Duration and iCalendar RRULE intervals for scheduling workflows.
Evaluating subscription rollups and expiration dates across varying calendar month lengths.
Calculating exact ISO 8601 intervals between start and end events in system audit logs.

Examples

1. Inspecting Standard and Extended Durations

Backend Engineer

Background

A backend engineer needs to verify incoming schedule configurations containing mixed duration formats, including week designators and negative intervals.

Problem

The system must confirm that all duration strings parse into correct individual time components before saving them into the database.

How to use

Set mode to 'Parse & Inspect', input duration strings separated by newlines, and set the anchor datetime.

mode: parse
durationsInput: P1Y2M3DT4H5M6S\nP3W\nPT36H\n-PT30M\nP0D\nP2W3D
anchorDatetime: 2026-01-15T00:00:00Z

Outcome

Receives a component table showing canonical formats, humanized text, exact seconds relative to the anchor, and flags for 8601-2 extensions.

2. Evaluating Multi-Month Calendar Arithmetic

Subscription Billing Specialist

Background

A billing specialist needs to calculate a prorated service extension by combining several duration adjustments with a subtracted promotional period.

Problem

Adding months and subtracting days yields different calendar results depending on whether calculations cross February or leap years.

FAQ

What duration formats does the workbench support?

It supports standard designators (P1Y2M3DT4H5M6S), week formats (P3W), time-only offsets (PT36H), negative durations (-PT30M), and ISO 8601-2 combined extensions (P2W3D).

Why is an anchor datetime needed for duration arithmetic?

Calendar units like months and years do not have fixed lengths, so an anchor timestamp is required to compute accurate day offsets across month boundaries and leap years.

How does expression mode evaluate duration calculations?

It parses additive and subtractive duration terms, applies them sequentially from the anchor datetime, and reconstructs the resulting difference as a normalized ISO duration.

How does sorting durations work?

It projects each duration from the specified anchor datetime, measures the exact elapsed seconds, and orders the list from shortest to longest.

What is the difference between parse mode and diff mode?

Parse mode inspects and normalizes existing duration strings, whereas diff mode calculates the ISO 8601 duration between two distinct datetimes.

mode: expression
durationsInput: P1Y2M + P11M - P90D
anchorDatetime: 2026-01-15T00:00:00Z

What this tool helps you do

Run this tool

Examples that match this tool

Continue with connected tools and hubs

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Overview

When to use

How it works

Use cases

Examples

1. Inspecting Standard and Extended Durations

2. Evaluating Multi-Month Calendar Arithmetic

FAQ

Nginx Log Parser Samples

ISO Viewer Samples

Android Image Processing Java Samples

Android Image Processing Kotlin Samples

Date Range Validator

Chess FEN, PGN & Elo Rating Tutor

Cron Expression Visualizer

CSV Malformed Row Surgeon