New FQ Lfunctions

Announcing new FQL features

We’re pleased to announce new FQL capabilities that empower users to write more concise and powerful FQL statements with:

  • Date/Time arithmetic functions
  • Any/All functions
  • Type cast functions
  • Type check functions

New preview features

Please note that these new functions are currently in Preview mode, which means that they will be fully supported in the JVM and JS drivers only and will continue to improve over the next 2 months. We invite you to send us feedback about their use. To learn more, please check out our documentation.

Date/Time arithmetic functions

The following Date/Time arithmetic functions have been implemented:

TimeAdd(), TimeSubtract(), and TimeDiff()

TimeAdd(Date("1970-01-01"), 1, "day")
TimeSubtract(Time("1970-01-01T00:00:00Z"), 10, "minutes")
TimeDiff(Date("1970-01-01"), Date("1970-01-02"), "days")

Any() and All() functions

Any() and All() reduce their parameter to a boolean: are any items true, or are all items true, respectively. They work like Or() and And() but for sets, arrays, and pages.

Unlike the existing boolean functions, Any() and All() have default values for empty inputs. (Any([]) returns false, and All([]) returns true).

Any(Map(Paginate(Match("user_ages_by_name", "Alice")), Lambda("age", GTE(Var("age"), 18)))

Type cast functions 

The following type casting functions have been implemented: 

ToDouble, ToArray, ToObject, and ToInteger

ToDouble(1) => 1.0
ToInteger(3.14) => 3
ToArray({x: 10, y: 20}) => [["x", 10], ["y", 20]]
ToObject([["x", 10], ["y", 20]]) => {x: 10, y: 20}

Type check functions 

The following type check functions have been implemented: 

IsNumber, IsDouble, IsInteger, IsBoolean, IsNull, IsBytes, IsTimestamp, IsDate, IsString, IsArray, IsObject, IsRef, IsSet, IsDoc, IsLambda, IsCollection, IsDatabase, IsIndex, IsFunction, IsKey, IsToken, IsCredentials, and IsRole 

An example of one of these in use:

IsDouble(3.14) => true

New GA Features 

We’re excited to announce that the new FQL functions that we released in Preview mode back in September are now generally available. This means that the functions are now also available in our Go, C#, and Python drivers. It also means that these functions are part of the FQL core product and you can expect them to be fully reliable. 

New GA functions include Range, Reduce, Format, and Merge. 

Conclusion 

With our latest FaunaDB update, users now have access to new FQL functionality including date arithmetic and type cast and check functions.

These methods are in Preview! So please let us know what you think so that we can incorporate feedback into the formal release, and visit our documentation to learn more. 

What other functions would you like to see implemented in FaunaDB? Please reach out to me on our Community Slack and describe any other features that would make FaunaDB an obvious choice for your next project.