Skip to content

Changelog

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.

Unreleased

0.2.0 - 2025-09-10

This release is a major change since the last version as it updates the ICU4X dependency from 1.x to 2.x. Take a look at the migration guide.

Added

  • fmt is now the main function to format dates, times, datetimes, and timezones. It's more expressive than the old individual functions.
  • zone-styles, alignment, fields, length, time-precision, and year-style contain the supported values for arguments to fmt. Their values are not implementation defined meaning you can rely on their string values.
  • There is now a new experimental pattern API.

Changed

  • The minimum Typst compiler version is now 0.13.0.

Removed

  • fmt-date, fmt-datetime, fmt-time, and experimental.fmt-{timezone, zoned-datetime} are replaced by fmt

0.1.2 - 2024-06-13

Added

  • The documentation is now hosted at nerixyz.github.io/icu-typ and includes more examples.
  • The offset in time zones can be specified as an int which specifies the offset in seconds.
  • 🚧 fmt-zoned-datetime: date-length and time-length now accept none.

Changed

  • 🚧 fmt-timezone: includes was renamed to format and doesn't accept an array anymore (passing an array with more than one item never worked).
  • 🚧 fmt-timezone: The -format suffix for options of format was removed.
  • 🚧 fmt-timezone: local-date now accepts dictionaries and datetimes without hour, minute, and second (default to 0) to be able to use datetime.today().

Fixed

  • Setting bcp47 in time zones now works correctly.
  • Setting metazone-id in time zones now works correctly.

0.1.1 - 2024-06-05

Added

  • locale-info - This function gets information about a locale identifier and how it was parsed.
  • This changelog was added.

Changed

  • 🚧 fmt-timezone: offset is now a named (but required) parameter to be more in sync with fmt-zoned-datetime (see example).
  • Updated README to show more locales.

Fixed

  • Removed redundant bytes() call

0.1.0 - 2024-05-31

Added

  • fmt-date
  • fmt-time
  • fmt-datetime
  • fmt-timezone (🚧 experimental)
  • fmt-zoned-datetime (🚧 experimental)