`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

Parameter	Type	Required	Description
time	String	true	Timestamp string in the form `yyyy-MM-ddThh:mm:ssTZO`.

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"
      }
    },
    ...
  ]
}