Introducing new capabilities for teams, third-party authentication and real-time database streaming!
Fauna logo
Log InSign Up
Fauna logo
Sign Up
© 2021 Fauna, Inc. All Rights Reserved.
<- Back
New FQ Lfunctions

Announcing New FQL Features

Lewis King|Dec 5th, 2019|



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.


With our latest Fauna 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 Fauna? Please reach out to me on our Community Slack and describe any other features that would make Fauna an obvious choice for your next project.

If you enjoyed our blog, and want to work on systems and challenges related to globally distributed systems, serverless databases, GraphQL, and Jamstack, Fauna is hiring!

Share this post


Subscribe to Fauna blogs & newsletter

Get latest blog posts, development tips & tricks, and latest learning material delivered right to your inbox.

<- Back