TimeDiff

Copied!
( start, finish, unit )

Description

The TimeDiff function returns the time difference between start and finish, expressed in unit units. The difference includes start but excludes finish.

Parameters

Argument Type Definition and Requirements

start

Date or Timestamp

The starting date or timestamp. start must match the type of finish.

finish

Date or Timestamp

The ending date or timestamp. finish must match the type of start.

unit

String

The type of unit that the difference should be expressed in.

When start and finish are Dates, unit must be one of day or days.

When start and finish are Timestamps, unit must be one of:

  • day, or days

  • half day, or half days

  • hour, or hours

  • minute, or minutes

  • second, or seconds

  • millisecond, or milliseconds

  • microsecond, or microseconds

  • nanosecond, or nanoseconds

Returns

A Number which represents the count of unit units between start and finish.

Examples

The following query demonstrates several time differences:

Copied!
client.query(
  q.(
    {
      'start': q.('1970-01-01T00:00:00+00:00'),
      'finish': q.(),
    },
    [
      q.(q.('1970-01-01'), q.(q.()), 'days'),
      q.(q.('start'), q.('finish'), 'days'),
      q.(q.('start'), q.('finish'), 'half days'),
      q.(q.('start'), q.('finish'), 'hours'),
      q.(q.('start'), q.('finish'), 'minutes'),
      q.(q.('start'), q.('finish'), 'seconds'),
      q.(q.('start'), q.('finish'), 'milliseconds'),
    ]
  )
)
.then((ret) => console.log(ret))
[ 18194, 18194, 36388, 436657, 26199422, 1571965360, 1571965360019 ]

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!