Time()

Convert a time String to an ISO-8601 time value Time value.

Signature

Time(timeString: String): Time

Description

The Time() method converts an ISO-8601 timeString 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 the Time.fromString() method.

Parameters

Parameter Type Required Description

timeString

String

Yes

Time String in the form yyyy-MM-ddThh:mm:ssTZO.

Return value

Type Description

Time

ISO-8601 time value object representing timeString.

Examples

Convert a time String to a Time value:

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

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

Customer.where( .ts == Time("2023-01-13T20:13:37.670Z") )
{
  data: [
    {
      id: "353770634073866274",
      coll: Customer,
      ts: Time("2023-01-13T20:13:37.670Z"),
      name: "Ignatious J. Reilly",
      address: {
        street: "811 Canal Street.",
        city: "New Orleans",
        state: "LA",
        country: "USA",
        zip: 70112
      }
    }
  ]
}

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!