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."""