tax-year

Download

This is a UK tax year utility. Therefore, it uses the Europe/London timezone.

Change History

v5.0 - 19 Jun 24

• add Scala 3.0 support, noting Scala 2.13 is still supported
• update library dependencies

v4.0 - 05 Dec 23

• update Scala 2.13 version
• update library dependencies
• add 'Change History' section to README

v3.3.0 - 01 Aug 23

• add README instructions

v3.2.0 - 06 May 22

• update Scala version

v2.0.0 - 07 Apr 22

• drop redundant scalatestplus-play dependency

import uk.gov.hmrc.time.TaxYear

Features

• getting the tax year for a given date

TaxYear.taxYearFor(LocalDate.of(2024, 7, 21)) // 2024 to 2025

• getting the current tax year

TaxYear.current // 2024 to 2025

• determining the extent of a tax year

TaxYear.current.starts   // 2024-04-06
TaxYear.current.finishes // 2025-04-05

• navigating tax years

TaxYear.current.previous // 2023 to 2024
TaxYear.current          // 2024 to 2025
TaxYear.current.next     // 2025 to 2026

• go back or forward by given tax years

TaxYear.current.back(2)     // 2022 to 2023
TaxYear.current.forwards(2) // 2026 to 2027

• determine if given date is within the tax year

TaxYear.current.contains(LocalDate.of(2024, 4, 5)) // false
TaxYear.current.contains(LocalDate.of(2024, 4, 6)) // true

Adding tax-year as a dependency

"uk.gov.hmrc" %% "tax-year" % "[INSERT_VERSION]"

License

This code is open source software licensed under the Apache 2.0 License.