convertUtcToPlainDate

Signature

convertUtcToPlainDate(value: string, options?: { timeZone?: string; }): string

Convert a UTC datetime string to a plain date string in the format “YYYY-MM-DD”.

• Converts to the timeZone option’s zone before extracting the date.
• A year outside 0000–9999 is written with a sign and six digits (+010000, -000005), as Temporal writes it, so the result is always a string isValidDate accepts.
• Returns "" for invalid input.

Parameters

Parameter	Type	Description
value	string	UTC datetime string (e.g., “2024-02-29T00:00:00Z”)

Options

options

The time zone the value is read in

Option	Type	Default	Description
timeZone?	string	"UTC"	The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone identifier such as +05:30, +0530 or -08, or a stored offset ±HH:MM[:SS], what getTimeZoneOffset returns), or "local" for the system time zone. An unknown zone returns "".

Returns

plain date string in “YYYY-MM-DD” format or "" on invalid input

Examples

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

convertUtcToPlainDate("2024-02-29T00:00:00Z") // "2024-02-29"

value

output

 

Source

utc/convert/convertUtcToPlainDate.ts