Check out v4 of the Fauna CLI

v4 of the Fauna CLI is now GA.

The new version introduces enhancements to the developer experience, including an improved authentication workflow. To get started, check out the CLI v4 quick start.

Migrating from v3 of the CLI? See the CLI migration guide.

Time()

Construct a Time from an ISO 8601 timestamp String.

Signature

Time(time: String) => Time

Description

Converts an ISO 8601 timestamp String to a Time value.

Parameter fields:

Time field Description

yyyy

Four-digit year.

MM

Month, from 01 to 12.

dd

Day, from 01 to 31.

T

Date and time separator.

hh

Hours, from 00 to 23.

mm

Minutes, from 00 to 59.

ss

Seconds, from 00 to 59, which can also be expressed as a decimal fraction to give nanosecond resolution.

TZO

Timezone offset from UTC which can be one of:

Timezone Description

Z

UTC, no offset

+hhmm

Positive hour and minute offset from UTC.

-hhmm

Negative hour and minute offset from UTC.

This method is equivalent to Time.fromString().

Parameters

Parameter Type Required Description

time

String

true

Timestamp string in the form yyyy-MM-ddThh:mm:ssTZO.

Return value

Type Description

Time

Time representation of the timestamp string.

Examples

Convert a time String to a Time value:

Time("2099-10-20T21:15:09.890729Z")
Time("2099-10-20T21:15:09.890729Z")

Test if a document timestamp is equal to a given time:

Customer.where(.ts == Time("2099-06-25T20:23:49.070Z"))
{
  data: [
    {
      id: "111",
      coll: Customer,
      ts: Time("2099-06-25T20:23:49.070Z"),
      cart: Order("412483941752112205"),
      orders: "hdW...",
      name: "Alice Appleseed",
      email: "alice.appleseed@example.com",
      address: {
        street: "87856 Mendota Court",
        city: "Washington",
        state: "DC",
        postalCode: "20220",
        country: "US"
      }
    },
    ...
  ]
}

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!