getUtcIn

Signature

getUtcIn(units: Partial<Record<keyof DurationLike, number>>): string

Return the UTC instant after now, as an ISO Instant string, counted from the current time.

Reads the clock once, after units is checked.
units is an object of unit amounts, such as { days: 90 }. A duration string returns "". A fractional amount returns "": write { hours: 36 } for a day and a half.
Lengths are unsigned: a negative amount returns "". getUtcAgo is the way back.
{ days: 0 } is a valid length and gives now.
Whole seconds, floored, always Z, so every form of one call names the same second. A caller who wants sub-seconds writes addUtc(getUtcNow(), units).
Calendar units count in UTC, so the result does not change with the server’s zone, and a missing day clamps to the end of the month, as addUtc does. For another zone’s wall clock, use getZonedIn.
It feeds formatHttpDate. A cookie Expires is formatHttpDate(getUtcIn({ days: 90 })), and a past one that deletes the cookie is formatHttpDate(getUtcAgo({ days: 1 })): RFC 6265 §4.1.2 says servers can delete a cookie by sending one with an Expires in the past (§3.1).
Each call reads the clock. To pin the start, use addUtc(getUtcNow(), units).
Examples read the clock at 2027-06-15T12:00:00Z.

Parameter	Type	Description
`units`	`Partial<Record<keyof DurationLike, number>>`	unit amounts, such as `{ days: 90 }`; never negative

ISO Instant string in whole seconds, or "" for invalid units, a negative amount or a result outside Temporal’s range

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

getUtcIn({ days: 90 }) // "2027-09-13T12:00:00Z" (an expiry 90 days out)

units amount

units unit

output