All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
2.3.1 - 2026-08-11
Fixes
- break adaptive
liveinterval loop at tier boundaries inTime - break adaptive
liveinterval loop at tier boundaries inDuration
2.3.0 - 2026-07-26
Features
- add
Countdowncomponent,svelteCountdownaction, andcountdownattachment - add
Stopwatchcomponent,svelteStopwatchaction, andstopwatchattachment - add
TimeRangecomponent,svelteTimeRangeaction, andtimeRangeattachment - add
svelte-time/intl, a zero-dependency Intl-based alternative
2.2.0 - 2026-07-08
Features
- add
Durationcomponent,svelteDurationaction, anddurationattachment - add
timeattachment - add
childrensnippet support for custom markup inTimeandDuration - add
tzprop for per-instance timezone conversion - add
relativeStyleprop for compact relative time output - add
relativeThresholdprop to control relative time thresholds - export
now,formatTime, andrelativeTimeprimitives - annotate generated locale union with human-readable names
- upgrade
dayjsto^1.11.21
Fixes
- preserve falsy timestamps in
svelteTime - emit valid ISO 8601
datetimevalues for non-string timestamps - restore hand-rolled
.d.tsfiles fordayjs,datetime, andtickersubpath exports - correct
formattyping, remove the phantomformattedprop, and export public types - avoid passing a
nulltitle tosetAttribute - improve type safety across
Time,Duration, formatting helpers, ticker utilities, and generated declarations
Performance
- parse timestamps once and reuse derived values
- update action output via
textContent - share a single live-update timer across components
- add adaptive live-update scheduling with visibility-aware refresh
2.1.0 - 2026-01-12
Features
- add
withoutSuffixprop to remove "ago" suffix from relative time (e.g., "2 hours" instead of "2 hours ago") - add
localeprop to support internationalization with multiple locales
2.0.2 - 2025-10-23
Fixes
- restore reactivity for
Timecomponent andsvelteTimeaction
2.0.1 - 2025-02-24
Fixes
- fix
svelteTimeimport in TypeScript definitions
2.0.0 - 2025-01-23
The library is modernized to only support Svelte 5 (Runes mode). There are no component API changes.
Use svelte-time@1.0.0 for Svelte 3/4 support. v1 is also compatible with Svelte 5 (non-Runes mode).
Breaking Changes
- update
Time.svelteto use Runes - update
svelteTimeaction to use Runes - update TypeScript definitions to replace deprecated
SvelteComponentTypedwithComponent
1.0.0 - 2025-01-23
Features
- establish a stable release before upgrading to Svelte 5
Fixes
- upgrade
dayjsto v1.11.13
0.9.0 - 2024-04-19
Features
- allow
titleattribute to be overridden
0.8.2 - 2023-12-16
Fixes
- fix
exportsin package.json to include types; add exports for./src/*.svelteand./src/*
0.8.1 - 2023-12-16
Fixes
- add
exportsto package.json to resolve Vite development warnings
0.8.0 - 2023-07-27
Breaking Changes
- minimum Svelte version required is 3.55
Features
- update type definitions to support Svelte 4
- upgrade
dayjsto v1.11.9
0.7.2 - 2023-06-04
- upgrade
dayjsto v1.11.8 - fix
Time.sveltetypes to allowdata-*attributes (e.g.,data-test-id)
0.7.1 - 2022-06-18
- use default CJS imports from
dayjsinstead of ESM - upgrade
dayjsto v1.11.3 - fix TypeScript definition for re-exported
dayjsfunction to extend therelativeTimeplugin - fix
svelteTimeaction to update when using a custom live interval - fix
svelteTimeaction to also set thedatetimeattribute
0.7.0 - 2022-05-15
- format
titleattribute usingformatprop when using relative time
0.6.3 - 2022-05-15
- revert back to using ESM exports from
dayjs
0.6.2 - 2022-05-15
- use default CJS imports from
dayjsinstead of ESM
0.6.1 - 2021-12-16
- set
type="module"in package.json
0.6.0 - 2021-10-10
- extend
TimePropsin svelte-time.d.tsSvelteTimeOptionsinterface
0.5.0 - 2021-09-15
- Use
.svelte.d.tsextension for component TypeScript definition
0.4.2 - 2021-09-01
- Update documentation on exported
dayjsfunction
0.4.1 - 2021-08-24
- Fix
liveprop value in README.md - Add example set-ups (SvelteKit, Vite, Sapper, Rollup, Webpack)
0.4.0 - 2021-07-27
- Export
dayjsfromsrc/index.js
0.3.1 - 2021-07-27
- Add TypeScript definition for
svelte-time/src/dayjsexport
0.3.0 - 2021-03-02
- Forward
$$restPropsto thetimeelement
0.2.0 - 2021-02-28
- Add
liveprop to update a relative timestamp at an interval
0.1.0 - 2021-02-27
- Initial release