vremel/CHANGELOG.md

JavaScript date utility library for Temporal API

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 0.6.1 (2025-08-03)

### Added

- `toObject` function

## 0.6.0 (2025-03-28)

### Added

- `epochMicroseconds` function

### Changed

- Drop CommonJS support. ([#4](https://github.com/fabon-f/vremel/pull/4))
- Drop support for outdated polyfills. ([f71e410](https://github.com/fabon-f/vremel/commit/f71e41070c2f75ff5761e025afeafb01e24ad07b))

## 0.5.1 (2025-03-18)

### Added

- `withDayOfWeek`, `isSameWeek` functions
- Support passing `ZonedDateTime` to `startOf*` and `endOf*` functions ([4ab5e3c](https://github.com/fabon-f/vremel/commit/4ab5e3c217d6eea8b4c3b3e42451d06bfec4d6d0), [6f829a2](https://github.com/fabon-f/vremel/commit/6f829a233bcea99b3d29e4e1df4e69708f5ab72e), [4b2f1ba](https://github.com/fabon-f/vremel/commit/4b2f1ba6b8c273acda237ac13c2915f00b3aa3b1), [8d48511](https://github.com/fabon-f/vremel/commit/8d48511f57bd2752eb0737e0e20c17203e3f97cf))

## 0.5.0 (2025-02-27)

### Added

- `startOfWeek` and `endOfWeek` functions
- `parse` function

### Changed

- Latin alphabets (`A` to `Z` and `a` to `z`) in the given format are now reserved for use as pattern characters in `formatWithoutLocale`. If you want to treat them as literal, escape them. ([39f5f9d](https://github.com/fabon-f/vremel/commit/39f5f9d7c6c3585796301992285b5ddfcaed46a1))

### Fixed

- Fix wrong type annotation in some functions ([eb95c5a](https://github.com/fabon-f/vremel/commit/eb95c5a214526b8f950c3952190135467f220fe1))

## 0.4.0 (2025-02-02)

### Added

- `fromJulianDate`, `fromModifiedJulianDate`, `modifiedJulianDate` functions
- `toDateFromExactTime` function

### Changed

- `toDateFromClockTime` returns `UTCDate` instead of `UTCDateMini` by default. `UTCDate` is upward compatible to `UTCDateMini` so this change will hardly introduce troubles. ([5c7ad45](https://github.com/fabon-f/vremel/commit/5c7ad45b49295ceca8732a285f5433dc3afe6a28))
- `julianDay` function is renamed to `julianDate` since the word 'julian day' is ambiguous. ([f393c25](https://github.com/fabon-f/vremel/commit/f393c25b7fc2c32327d009cee4a5d8b3dfeb2ef9))
- `areIntervalsOverlapping`, `clamp`, `compareAsc`, `compareDesc`, `earliest`, `isAfter`, `isBefore`, `isWithinInterval`, `latest` functions now reject `PlainYearMonth` with different calendar because it's semantically nonsense in most cases. ([197c7c9](https://github.com/fabon-f/vremel/commit/197c7c9e2507f3a68a047afc673fdb4f8bd81f89))
- `formatWithoutLocale` supports `VV` token (time zone ID) ([3a651ce](https://github.com/fabon-f/vremel/commit/3a651ce409452f1c2e3a2c17f6727eb2ce43451f))

### Fixed

- Fix TypeScript error when using from CommonJS ([7823d45](https://github.com/fabon-f/vremel/commit/7823d451cd34faabeb84267c34c5a54046b735ca))

## 0.3.4 (2024-09-12)

### Added

- `startOfYear`, `startOfMonth`, `startOfDay`, `startOfHour`, `startOfMinute`, `startOfSecond`, `endOfYear`, `endOfMonth`, `endOfDay`, `endOfHour`, `endOfMinute`, `endOfSecond` functions
- `fromRfc2822`, `fromRfc7231`, `formatRfc7231`, `epochSeconds`, `julianDay` functions

### Changed

- Make `formatWithoutLocale` not accept a temporal objects with non-ISO calendar by default. If you want to do that, please use `formatNonIsoDate` option.

## 0.3.3 (2024-05-09)

### Removed

- Stop exporting `Temporal` type from main module because it messed up docs. ([1126424](https://github.com/fabon-f/vremel/commit/1126424c2cd077267080a1dfa7c966ae4b499192))

## 0.3.2 (2024-05-09)

### Added

- Export custom types and `Temporal` itself in main module. ([6765b8d](https://github.com/fabon-f/vremel/commit/6765b8dd0b5e6e22d5088bbb93f9a99c0acddb84))

### Changed

- Move API docs to [JSR](https://jsr.io/@fabon/vremel/doc).

### Removed

- Stop exporting the namespace `duration` from main module. You can still import functions from `vremel/duration`. ([ffc4687](https://github.com/fabon-f/vremel/commit/ffc468739ea977904ad10e2782c4b3b49634260e))

## 0.3.1 (2024-05-08)

### Changed

- Update the type definition for Temporal API to latest spec. ([373c2ce](https://github.com/fabon-f/vremel/commit/373c2ce8434a2282ee12f859c8aefb9362524835))

## 0.3.0 (2024-03-11)

### Added

- `areIntervalsOverlapping`, `clamp`, `isWithinInterval` functions

### Changed

- Stop converting calendar automatically in `closestIndexTo` and `closestTo` for consistency with other functions. ([dcd1f37](https://github.com/fabon-f/vremel/commit/dcd1f37eb5c1de70a3bde61de88bce879e4aa8e8))

## 0.2.0 (2024-03-03)

### Added

- `toTemporalFromClockTime`, `formatWithoutLocale` functions

### Changed

- Change type signatures of functions, using generics instead of overload functions. ([be7da06](https://github.com/fabon-f/vremel/commit/be7da062168f2ca26152f885fbc275db2d631323))

## 0.1.2 (2024-02-13)

### Added

- `toDateFromClockTime`, `closestTo`, `closestIndexTo` functions

### Fixed

- Fix a broken type definition.

## 0.1.1 (2024-02-12)

### Fixed

- Fix a bug that some functions are not exported from the package.

## 0.1.0 (2024-02-12)

### Added

- `earliest`, `latest`, `isAfter`, `isBefore`, `compareAsc`, `compareDesc` functions
- `isEqual`, `longest`, `shortest` functions in `vremel/duration`