convertUnixToPlainDate
Signature
Section titled “Signature”convertUnixToPlainDate(unix: number, options?: { epochUnit?: "seconds" | "milliseconds"; timeZone?: string; }): stringimport { convertUnixToPlainDate } from "@northguild/gmt/unix/convert";Convert a Unix timestamp to a plain date string in the format “YYYY-MM-DD”.
- Converts to PlainDate using the specified or system timezone.
- Validates epoch unit (“seconds” | “milliseconds”).
- Returns “” for invalid input.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
unix |
number |
Unix timestamp (number) |
Options
Section titled “Options”options
| Option | Type | Default |
|---|---|---|
epochUnit? |
"seconds" | "milliseconds" |
— |
timeZone? |
string |
— |
Returns
Section titled “Returns”plain date string in “YYYY-MM-DD” format or “” on invalid input
Examples
Section titled “Examples”convertUnixToPlainDate(1709164800000) // "2024-02-29"convertUnixToPlainDate(1709164800, { epochUnit: "seconds" }) // "2024-02-29"convertUnixToPlainDate(-1) // "1969-12-31"