# bitwalker/timex

A complete date/time library for Elixir projects.

Repository: https://github.com/bitwalker/timex
Canonical: https://ross.abutalabs.com/products/timex
Homepage: https://hexdocs.pm/timex
Language: Elixir
License: MIT
License Family: permissive
Topics: elixir, datetime, calendar
Last push: 2025-06-14T16:17:58+00:00

## Health v2 (maintenance only)
Score: 34/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 26, release rhythm 8, longevity 100
- inputs: {"age_days": 4420, "days_push": 445, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1807, forks 405 (observed 2026-08-28T04:05:39.244900+00:00)

## What it is
Timex is a comprehensive date/time library for Elixir with full timezone support via the tzdata package. It provides rich APIs for manipulating dates, times, datetimes, and timestamps, and integrates with Ecto via the timex_ecto package.

## Use cases
- parse and format dates in elixir
- convert datetimes between timezones
- manipulate timestamps in elixir
- use datetime types with ecto
- work with the olson timezone database

## When to choose
- you need timezone-aware datetime handling beyond Elixir's built-in Calendar API
- you need custom formatters and parsers for dates
- you want Ecto integration for datetime types

## When to avoid
- the standard library Calendar API covers your needs and you want to avoid a dependency
- you need timezone standards other than Olson tzdata or POSIX-TZ

## Facets
- artifact type: library
- maturity: maintenance
- function: date-time, serialization
- domain: developer-tools, backend
- platform: elixir, jvm
- tags: datetime, timezone, calendar, tzdata, ecto

## Member repositories
- bitwalker/timex (main) score 34

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:39.244900+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:21:26.239784+00:00, confidence not recorded.
  - readme: https://github.com/bitwalker/timex (fetched 2026-08-28T04:05:39.244900+00:00, sha 4df297977e2c)
  - homepage: https://hexdocs.pm/timex (fetched 2026-08-29T11:00:22.530956+00:00, sha f049d415de35)
- Data as of 2026-08-30T08:39:29.467469+00:00.