1Overview

The Long scalar type represents a signed 64-bit integer. It is intended for scenarios where values exceed the range of the built-in Int scalar, such as representing large identifiers, timestamps in milliseconds, file sizes in bytes, or any integer values requiring more than 32 bits.

Unlike the built-in Int scalar which represents signed 32-bit integers with a range of -2,147,483,648 to 2,147,483,647, Long supports values in the range -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807.

Note: JavaScript’s JSON.parse() does not safely support 64-bit integers. Values outside the safe integer range (-(2^53 - 1) to 2^53 - 1) may lose precision when parsed as JavaScript numbers. Client applications using JavaScript should handle Long values with care, potentially using libraries like json-bigint or representing them as strings.

2Recommended name

The recommended name for this scalar is Long.

3Result spec

A Long scalar must serialize to an integer value in the range -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 (inclusive).

4Input spec

A Long scalar accepts integer values in the range -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 (inclusive), both as GraphQL literals and as JSON input values.

Implementations should validate:

• Value is an integer (no fractional component)
• Value is between -9,223,372,036,854,775,808 and 9,223,372,036,854,775,807 (inclusive)

query {
  fileInfo(sizeInBytes: 5368709120) {
    name
  }
}

{
  "sizeInBytes": 5368709120
}

{
  "timestamp": 1609459200000
}

5References

• GraphQL Specification – Int — Built-in integer scalar type