@rtorcato/js-common / datetime
datetime
Functions
nowIso()
nowIso():
string
Defined in: datetime/index.ts:9
Returns the current date and time as an ISO string (YYYY-MM-DDTHH:mm:ss.sssZ).
Example
nowIso() // '2026-08-11T14:03:27.913Z'
Returns
string
parseIsoDateTime()
parseIsoDateTime(
iso):Date|null
Defined in: datetime/index.ts:24
Parses an ISO date-time string to a Date object. Returns null if invalid.
Example
parseIsoDateTime('2026-08-11T14:03:27Z')?.getUTCHours() // 14
parseIsoDateTime('not-a-date') // null
Parameters
iso
string
The ISO string.
Returns
Date | null
formatDateTimeLocal()
formatDateTimeLocal(
date):string
Defined in: datetime/index.ts:39
Formats a Date as YYYY-MM-DD HH:mm:ss (local time).
Example
formatDateTimeLocal(new Date(2026, 7, 11, 9, 5, 3)) // '2026-08-11 09:05:03'
Parameters
date
Date
The Date object.
Returns
string
getTimezoneOffset()
getTimezoneOffset(
date?):number
Defined in: datetime/index.ts:51
Returns the timezone offset in minutes for a given date (local − UTC).
Parameters
date?
Date = ...
The Date object.
Returns
number
toUtcDate()
toUtcDate(
date):Date
Defined in: datetime/index.ts:59
Returns the UTC equivalent of a local Date.
Parameters
date
Date
The local Date object.
Returns
Date
unixTimestamp()
unixTimestamp():
number
Defined in: datetime/index.ts:76
Returns the number of seconds since the Unix epoch (UTC).
Returns
number
unixMillis()
unixMillis():
number
Defined in: datetime/index.ts:83
Returns the number of milliseconds since the Unix epoch.
Returns
number
getIsoWeek()
getIsoWeek(
date):number
Defined in: datetime/index.ts:91
Returns the ISO week number (1–53) of a given date using UTC.
Parameters
date
Date
A JavaScript Date object.
Returns
number
getIsoWeekInfo()
getIsoWeekInfo(
date):object
Defined in: datetime/index.ts:117
Returns ISO week number and ISO week year (which may differ from calendar year).
Parameters
date
Date
Date object (UTC-safe)
Returns
object
week
week:
number
year
year:
number