toSeconds

Converts a date to a timestamp in seconds (epoch seconds).

Use this when sending a date to a backend API that expects seconds (e.g. Java Instant.getEpochSecond(), Python time.time()).

Available since v2.0.0

Import

import { toSeconds } from '@helpers4/date';
// or, from the all-in-one package (same code, one install):
import { toSeconds } from 'helpers4/date';

toSeconds(date: DateLike): number | null

Parameter	Type	Description
`date`	`DateLike`	The date to convert

number | null — Seconds since the Unix epoch, or null for invalid input

toSeconds('2025-01-19T12:00:00Z') // => 1737288000
toSeconds(null)                    // => null

A value that can be converted to a Date.

Date — used as-is (validated for Invalid Date)
number — treated as a timestamp (seconds or milliseconds, auto-detected); 0 is treated as invalid and produces null in ensureDate
string — parsed via new Date(string)
Temporal.Instant | Temporal.ZonedDateTime — read via their epochMilliseconds property

type DateLike = Date | number | string | Temporal.Instant | Temporal.ZonedDateTime