convertUtcToUnix

Signature

convertUtcToUnix(value: string, unit?: UnixUnit): number

import { convertUtcToUnix } from "@northguild/gmt/utc/convert";

Convert a UTC Instant string to a unix epoch value in milliseconds or seconds.

• Uses Temporal.Instant.from to parse.
• Validates unit (“seconds” | “milliseconds”).
• Returns null for invalid input.

Parameters

Parameter	Type	Description
value	string	UTC Instant string
unit	``	optional unit, “seconds” or “milliseconds”

Returns

epoch number or null on invalid

Related types

• UnixUnit

Examples

convertUtcToUnix("2024-02-29T00:00:00Z") // 1709164800000
convertUtcToUnix("2024-02-29T00:00:00Z", "seconds") // 1709164800
convertUtcToUnix("invalid") // null

Source

utc/convert/convertUtcToUnix.ts