Skip to content

convertUtcToPlainDateTime

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

Convert a UTC datetime string to a plain datetime string in the format “YYYY-MM-DDTHH:mm:ss”.

  • Converts to the timeZone option’s zone before extracting the datetime.
  • The time is cut to the second: a fraction of a second in value is dropped.
  • 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 isValidDateTime accepts.
  • Returns "" for invalid input.
ParameterTypeDescription
valuestringUTC datetime string (e.g., “2024-02-29T00:00:00Z”)

options

The time zone the value is read in

OptionTypeDefaultDescription
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 "".

plain datetime string in “YYYY-MM-DDTHH:mm:ss” format or "" on invalid input

import { convertUtcToPlainDateTime } from "@northguild/gmt/utc/convert";
convertUtcToPlainDateTime("2024-02-29T00:00:00Z") // "2024-02-29T00:00:00"
output 

utc/convert/convertUtcToPlainDateTime.ts