Skip to main content

@rtorcato/js-common / datetime

datetime

Functions

nowIso()

nowIso(): string

Defined in: datetime/index.ts:4

Returns the current date and time as an ISO string (YYYY-MM-DDTHH:mm:ss.sssZ).

Returns

string


parseIsoDateTime()

parseIsoDateTime(iso): Date | null

Defined in: datetime/index.ts:12

Parses an ISO date-time string to a Date object. Returns null if invalid.

Parameters

iso

string

The ISO string.

Returns

Date | null


formatDateTimeLocal()

formatDateTimeLocal(date): string

Defined in: datetime/index.ts:21

Formats a Date as YYYY-MM-DD HH:mm:ss (local time).

Parameters

date

Date

The Date object.

Returns

string


getTimezoneOffset()

getTimezoneOffset(date?): number

Defined in: datetime/index.ts:33

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:41

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:58

Returns the number of seconds since the Unix epoch (UTC).

Returns

number


unixMillis()

unixMillis(): number

Defined in: datetime/index.ts:65

Returns the number of milliseconds since the Unix epoch.

Returns

number


secondsBetween()

secondsBetween(a, b): number

Defined in: datetime/index.ts:74

Returns the difference in seconds between two Date objects.

Parameters

a

Date

First date.

b

Date

Second date.

Returns

number


getIsoWeek()

getIsoWeek(date): number

Defined in: datetime/index.ts:82

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:108

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