from __future__ import annotations

import datetime as dt

# Temporal (from `polars._utils.constants`)
SECONDS_PER_DAY = 86_400
SECONDS_PER_MINUTE = 60
NS_PER_MINUTE = 60_000_000_000
"""Nanoseconds (`[ns]`) per minute."""
US_PER_MINUTE = 60_000_000
"""Microseconds (`[μs]`) per minute."""
MS_PER_MINUTE = 60_000
"""Milliseconds (`[ms]`) per minute."""
NS_PER_SECOND = 1_000_000_000
"""Nanoseconds (`[ns]`) per second (`[s]`)."""
US_PER_SECOND = 1_000_000
"""Microseconds (`[μs]`) per second (`[s]`)."""
MS_PER_SECOND = 1_000
"""Milliseconds (`[ms]`) per second (`[s]`)."""
NS_PER_MICROSECOND = 1_000
"""Nanoseconds (`[ns]`) per microsecond (`[μs]`)."""
NS_PER_MILLISECOND = 1_000_000
"""Nanoseconds (`[ns]`) per millisecond (`[ms]`).

From [polars](https://github.com/pola-rs/polars/blob/2c7a3e77f0faa37c86a3745db4ef7707ae50c72e/crates/polars-time/src/chunkedarray/duration.rs#L7).
"""
EPOCH_YEAR = 1970
"""See [Unix time](https://en.wikipedia.org/wiki/Unix_time)."""
EPOCH = dt.datetime(EPOCH_YEAR, 1, 1).replace(tzinfo=None)
"""See [Unix time](https://en.wikipedia.org/wiki/Unix_time)."""

GET_CATEGORIES_DEPRECATION_TEMPLATE = (
    "`{cls}.cat.get_categories` is deprecated and it will be removed in a future version.\n\n"
    "To get the distinct values present in a Categorical column, use `{cls}.unique`.\n"
    "For the fixed category list of an Enum, use its `dtype.categories`.\n\n"
    "Note: `cat.get_categories` will remain available in `narwhals.stable.v1` and\n"
    "`narwhals.stable.v2`.\n"
    "See https://narwhals-dev.github.io/narwhals/backcompat/ for more information.\n"
)
"""Deprecation message for `cat.get_categories`, mirroring Polars' one."""