Skip to content

convertUnixToUtc

convertUnixToUtc(value: number, unit?: UnixUnit): string
import { convertUnixToUtc } from "@northguild/gmt/unix/convert";

Convert a unix epoch value to a UTC Instant ISO string.

  • Converts to UTC Instant using Temporal.Instant.
  • Validates value and epoch unit (“seconds” | “milliseconds”).
  • Returns “” for invalid input.
Parameter Type Description
value number epoch value (number)
unit `` optional unit, “seconds” or “milliseconds”

UTC Instant string or “” on invalid

convertUnixToUtc(1709164800000) // "2024-02-29T00:00:00Z"
convertUnixToUtc(1709164800, "seconds") // "2024-02-29T00:00:00Z"
convertUnixToUtc(-1) // "1969-12-31T23:59:59.999Z"

unix/convert/convertUnixToUtc.ts