ToSeconds

Copied!
( value )

Description

The ToSeconds function converts a value to the number of seconds since Unix epoch (midnight, January 1, 1970), if possible.

Attempting to convert a value to a number of seconds which has no numeric representation results in an "invalid argument" error.

Parameters

Parameter Type Definition and Requirements

value

Any

The value to attempt to convert to a number of seconds since Unix epoch.

If you provide a Number, it is interpreted as the number of microseconds since Unix epoch.

Returns

A Number representing the number of seconds since Unix epoch.

Examples

The following query calls ToSeconds twice:

  1. To convert 1 second after Unix epoch into seconds.

  2. To convert the current transaction time into seconds.

Copied!
[
  ((1, 'second')),
  (('2020-07-06T12:34:56.789Z'))
]
[ 1, 1594038896 ]
Query metrics:

  •    bytesIn:  95

  •   bytesOut:  27

  • computeOps:   1

  •    readOps:   0

  •   writeOps:   0

  •  readBytes:   0

  • writeBytes:   0

  •  queryTime: 2ms

  •    retries:   0

Is this article helpful? 

Tell Fauna how the article can be improved:
 Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!