Skip to content

parseYearFromUnix

parseYearFromUnix(value: string | number, options?: { epochUnit?: UnixUnit; timeZone?: string; }): string
import { parseYearFromUnix } from "@northguild/gmt/unix/parse";

Return the year from a unix epoch value.

  • Delegates to {@link parseUnitFromUnix} with unit “year”.
  • Returns “” for invalid input.
Parameter Type Description
value string | number unix epoch in milliseconds or seconds (number or string)

options

Option Type Default
epochUnit? UnixUnit
timeZone? string

Year (YYYY) or “” on invalid input

parseYearFromUnix(1700000000000) // "2023"
parseYearFromUnix(1704067200000, { epochUnit: "milliseconds" }) // "2024"
parseYearFromUnix(-86400, { epochUnit: "seconds" }) // "1969"

unix/parse/parseYearFromUnix.ts