getUtcNowUnit

Signature

getUtcNowUnit(unit: any): string

import { getUtcNowUnit } from "@northguild/gmt/utc/get";

Return the requested unit value from the current UTC instant.

• Valid units: “year”, “month”, “week”, “day”, “dayOfWeek”, “hour”, “minute”, “second”, “millisecond”, “microsecond”, “nanosecond”.
• Uses Temporal.Now.instant() converted to UTC.
• Returns “” on invalid unit or failure.

Parameters

Parameter	Type	Description
unit	any	unit to extract from current utc instant

Returns

string representation of the requested unit or “” on invalid

Related types

• NowUnit
• UtcNowUnit

Examples

getUtcNowUnit("year") // "2024"
getUtcNowUnit("month") // "02"
getUtcNowUnit("invalid") // ""

Source

utc/get/getUtcNowUnit.ts