Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Documentation de référence sur les fonctions d'horodatage

Fonctions de code temporel

Nom	Description
`CURRENT_TIMESTAMP`	Génère un `TIMESTAMP` correspondant à l'heure de la requête.
`TIMESTAMP_TRUNC`	Tronque une valeur `TIMESTAMP` selon un niveau de précision donné.
`UNIX_MICROS_TO_TIMESTAMP`	Convertit le nombre de microsecondes écoulées depuis le `1970-01-01 00:00:00 UTC` en `TIMESTAMP`.
`UNIX_MILLIS_TO_TIMESTAMP`	Convertit le nombre de millisecondes écoulées depuis le `1970-01-01 00:00:00 UTC` en `TIMESTAMP`.
`UNIX_SECONDS_TO_TIMESTAMP`	Convertit le nombre de secondes écoulées depuis le `1970-01-01 00:00:00 UTC` en `TIMESTAMP`.
`TIMESTAMP_ADD`	Ajoute un intervalle de temps à un `TIMESTAMP`.
`TIMESTAMP_SUB`	Soustrait un intervalle de temps d'une valeur `TIMESTAMP`.
`TIMESTAMP_TO_UNIX_MICROS`	Convertit une valeur `TIMESTAMP` en nombre de microsecondes écoulées depuis le `1970-01-01 00:00:00 UTC`.
`TIMESTAMP_TO_UNIX_MILLIS`	Convertit une valeur `TIMESTAMP` en nombre de millisecondes écoulées depuis le `1970-01-01 00:00:00 UTC`.
`TIMESTAMP_TO_UNIX_SECONDS`	Convertit une valeur `TIMESTAMP` en nombre de secondes écoulées depuis le `1970-01-01 00:00:00 UTC`.
`TIMESTAMP_DIFF`	Renvoie le nombre entier d'intervalles `unit` spécifiés entre deux `TIMESTAMP`.
`TIMESTAMP_EXTRACT`	Extrait un `part` spécifique (par exemple, l'année, le mois ou le jour) d'un `TIMESTAMP`.

CURRENT_TIMESTAMP

Syntaxe :

current_timestamp() -> TIMESTAMP

Description :

Récupère le code temporel au début de l'heure de la requête input (interprété comme le nombre de microsecondes depuis 1970-01-01 00:00:00 UTC).

Cette valeur est stable dans une requête et renvoie toujours la même valeur si elle est appelée plusieurs fois.

TIMESTAMP_TRUNC

Syntaxe :

timestamp_trunc(timestamp: TIMESTAMP | BSON_TIMESTAMP, granularity: STRING[, timezone: STRING]) -> TIMESTAMP

Description :

Tronque un code temporel selon un niveau de précision donné.

L'argument granularity doit être une chaîne et l'un des éléments suivants :

microsecond
millisecond
second
minute
hour
day
week
week([weekday])
month
quarter
year
isoyear

Si l'argument timezone est fourni, la troncature sera basée sur les limites du calendrier du fuseau horaire donné (par exemple, la troncature du jour sera tronquée à minuit dans le fuseau horaire donné). La troncature respectera l'heure d'été.

Si timezone n'est pas fourni, la troncature sera basée sur les limites du calendrier UTC.

L'argument timezone doit être une représentation sous forme de chaîne d'un fuseau horaire de la base de données tz, par exemple America/New_York. Vous pouvez également utiliser un horodatage personnalisé en spécifiant un décalage par rapport à GMT.

Exemples :

`timestamp`	`granularity`	`timezone`	`timestamp_trunc(timestamp, granularity, timezone)`
2000-01-01 10:20:30:123456 UTC	"second"	Non fourni	2001-01-01 10:20:30 UTC
1997-05-31 04:30:30 UTC	"day"	Non fourni	1997-05-31 00:00:00 UTC
1997-05-31 04:30:30 UTC	"day"	"America/Los_Angeles"	1997-05-30 07:00:00 UTC
2001-03-16 04:00:00 UTC	"week(friday)	Non fourni	2001-03-16 00:00:00 UTC
2001-03-23 04:00:00 UTC	"week(friday)	"America/Los_Angeles"	2001-03-23 17:00:00 UTC
2026-01-24 20:00:00 UTC	"month"	"GMT+06:32:43"	2026-01-01T06:32:43 UTC

UNIX_MICROS_TO_TIMESTAMP

Syntaxe :

unix_micros_to_timestamp(input: INT64) -> TIMESTAMP

Description :

Convertit input (interprété comme le nombre de microsecondes écoulées depuis le 1970-01-01 00:00:00 UTC) en TIMESTAMP. Génère une erreur error si input ne peut pas être converti en une valeur TIMESTAMP valide.

Exemples :

`input`	`unix_micros_to_timestamp(input)`
0L	1970-01-01 00:00:00 UTC
400123456L	1970-01-01 00:06:40.123456 UTC
-1000000L	1969-12-31 23:59:59 UTC

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("createdAtMicros").unixMicrosToTimestamp().as("createdAtString")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("createdAtMicros").unixMicrosToTimestamp().as("createdAtString")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("createdAtMicros").unixMicrosToTimestamp().as("createdAtString")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtMicros").unixMicrosToTimestamp().alias("createdAtString")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtMicros").unixMicrosToTimestamp().alias("createdAtString")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("createdAtMicros")
        .unix_micros_to_timestamp()
        .as_("createdAtString")
    )
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(unixMicrosToTimestamp(field("createdAtMicros")).as("createdAtString"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.UnixMicrosToTimestamp(firestore.FieldOf("createdAtMicros")).As("createdAtString"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

UNIX_MILLIS_TO_TIMESTAMP

Syntaxe :

unix_millis_to_timestamp(input: INT64) -> TIMESTAMP

Description :

Convertit input (interprété comme le nombre de millisecondes écoulées depuis 1970-01-01 00:00:00 UTC) en TIMESTAMP. Génère une erreur error si input ne peut pas être converti en une valeur TIMESTAMP valide.

Exemples :

`input`	`unix_millis_to_timestamp(input)`
0L	1970-01-01 00:00:00 UTC
4000123L	1970-01-01 01:06:40.123 UTC
-1000000L	1969-12-31 23:43:20 UTC

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("createdAtMillis").unixMillisToTimestamp().as("createdAtString")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("createdAtMillis").unixMillisToTimestamp().as("createdAtString")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("createdAtMillis").unixMillisToTimestamp().as("createdAtString")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtMillis").unixMillisToTimestamp().alias("createdAtString")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtMillis").unixMillisToTimestamp().alias("createdAtString")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("createdAtMillis")
        .unix_millis_to_timestamp()
        .as_("createdAtString")
    )
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(unixMillisToTimestamp(field("createdAtMillis")).as("createdAtString"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.UnixMillisToTimestamp(firestore.FieldOf("createdAtMillis")).As("createdAtString"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

UNIX_SECONDS_TO_TIMESTAMP

Syntaxe :

unix_seconds_to_timestamp(input: INT64) -> TIMESTAMP

Description :

Convertit input (interprété comme le nombre de secondes écoulées depuis 1970-01-01 00:00:00 UTC) en TIMESTAMP. Génère une erreur error si input ne peut pas être converti en une valeur TIMESTAMP valide.

Exemples :

`input`	`unix_seconds_to_timestamp(input)`
0L	1970-01-01 00:00:00 UTC
60L	1970-01-01 00:01:00 UTC
-300L	1969-12-31 23:55:00 UTC

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("createdAtSeconds").unixSecondsToTimestamp().as("createdAtString")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("createdAtSeconds").unixSecondsToTimestamp().as("createdAtString")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("createdAtSeconds").unixSecondsToTimestamp().as("createdAtString")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtSeconds").unixSecondsToTimestamp().alias("createdAtString")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAtSeconds").unixSecondsToTimestamp().alias("createdAtString")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("createdAtSeconds")
        .unix_seconds_to_timestamp()
        .as_("createdAtString")
    )
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(unixSecondsToTimestamp(field("createdAtSeconds")).as("createdAtString"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.UnixSecondsToTimestamp(firestore.FieldOf("createdAtSeconds")).As("createdAtString"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_ADD

Syntaxe :

timestamp_add(timestamp: TIMESTAMP | BSON_TIMESTAMP, unit: STRING, amount: INT64) -> TIMESTAMP

Description :

Ajoute un amount de unit à partir de timestamp. L'argument amount peut être négatif, auquel cas il équivaut à TIMESTAMP_SUB.

L'argument unit doit être une chaîne et l'un des éléments suivants :

microsecond
millisecond
second
minute
hour
day

Génère une erreur si le code temporel obtenu ne se situe pas dans la plage TIMESTAMP.

Exemples :

`timestamp`	`unit`	`amount`	`timestamp_add(timestamp, unit, amount)`
2025-02-20 00:00:00 UTC	"minute"	2L	2025-02-20 00:02:00 UTC
2025-02-20 00:00:00 UTC	"hour"	-4L	2025-02-19 20:00:00 UTC
2025-02-20 00:00:00 UTC	"day"	5L	2025-02-25 00:00:00 UTC

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("createdAt").timestampAdd("day", 3653).as("expiresAt")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("createdAt").timestampAdd("day", 3653).as("expiresAt")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("createdAt").timestampAdd(3653, .day).as("expiresAt")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAt")
          .timestampAdd("day", 3653)
          .alias("expiresAt")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("createdAt").timestampAdd("day", 3653).alias("expiresAt")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(Field.of("createdAt").timestamp_add("day", 3653).as_("expiresAt"))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(timestampAdd(field("createdAt"), "day", 3653).as("expiresAt"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.TimestampAdd(firestore.FieldOf("createdAt"), "day", 3653).As("expiresAt"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_SUB

Syntaxe :

timestamp_sub(timestamp: TIMESTAMP | BSON_TIMESTAMP, unit: STRING, amount: INT64) -> TIMESTAMP

Description :

Soustrait un amount de unit de timestamp. L'argument amount peut être négatif, auquel cas il équivaut à TIMESTAMP_ADD.

L'argument unit doit être une chaîne et l'un des éléments suivants :

microsecond
millisecond
second
minute
hour
day

Génère une erreur si le code temporel obtenu ne se situe pas dans la plage TIMESTAMP.

Exemples :

`timestamp`	`unit`	`amount`	`timestamp_sub(timestamp, unit, amount)`
2026-07-04 00:00:00 UTC	"minute"	40L	2026-07-03 23:20:00 UTC
2026-07-04 00:00:00 UTC	"hour"	-24L	2026-07-05 00:00:00 UTC
2026-07-04 00:00:00 UTC	"day"	3L	2026-07-01 00:00:00 UTC

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("expiresAt").timestampSubtract("day", 14).as("sendWarningTimestamp")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("expiresAt").timestampSubtract("day", 14).as("sendWarningTimestamp")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("expiresAt").timestampSubtract(14, .day).as("sendWarningTimestamp")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("expiresAt")
          .timestampSubtract("day", 14)
          .alias("sendWarningTimestamp")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("expiresAt").timestampSubtract("day", 14).alias("sendWarningTimestamp")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("expiresAt")
        .timestamp_subtract("day", 14)
        .as_("sendWarningTimestamp")
    )
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(timestampSubtract(field("expiresAt"), "day", 14).as("sendWarningTimestamp"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.TimestampSubtract(firestore.FieldOf("expiresAt"), "day", 14).As("sendWarningTimestamp"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_TO_UNIX_MICROS

Syntaxe :

timestamp_to_unix_micros(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

Description :

Convertit input en nombre de microsecondes écoulées depuis le 1970-01-01 00:00:00 UTC. Tronque les niveaux de précision plus élevés en arrondissant au début de la microseconde.

Exemples :

`input`	`timestamp_to_unix_micros(input)`
1970-01-01 00:00:00 UTC	0L
1970-01-01 00:06:40.123456 UTC	400123456L
1969-12-31 23:59:59 UTC	-1000000L

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixMicros().as("unixMicros")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixMicros().as("unixMicros")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("dateString").timestampToUnixMicros().as("unixMicros")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixMicros().alias("unixMicros")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixMicros().alias("unixMicros")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(Field.of("dateString").timestamp_to_unix_micros().as_("unixMicros"))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(timestampToUnixMicros(field("dateString")).as("unixMicros"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.TimestampToUnixMicros(firestore.FieldOf("dateString")).As("unixMicros"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_TO_UNIX_MILLIS

Syntaxe :

timestamp_to_unix_millis(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

Description :

Convertit input en nombre de millisecondes depuis le 1970-01-01 00:00:00 UTC. Tronque les niveaux de précision plus élevés en arrondissant au début de la milliseconde.

Exemples :

`input`	`timestamp_to_unix_millis(input)`
1970-01-01 00:00:00 UTC	0L
1970-01-01 01:06:40.123 UTC	4000123L
1969-12-31 23:43:20	-1000000L

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixMillis().as("unixMillis")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixMillis().as("unixMillis")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("dateString").timestampToUnixMillis().as("unixMillis")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixMillis().alias("unixMillis")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixMillis().alias("unixMillis")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(Field.of("dateString").timestamp_to_unix_millis().as_("unixMillis"))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(timestampToUnixMillis(field("dateString")).as("unixMillis"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.TimestampToUnixMillis(firestore.FieldOf("dateString")).As("unixMillis"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_TO_UNIX_SECONDS

Syntaxe :

timestamp_to_unix_seconds(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

Description :

Convertit input en nombre de secondes écoulées depuis le 1970-01-01 00:00:00 UTC. Tronque les niveaux de précision plus élevés en arrondissant au début de la seconde.

Exemples :

`input`	`timestamp_to_unix_seconds(input)`
1970-01-01 00:00:00 UTC	0L
1970-01-01 00:01:00 UTC	60L
1969-12-31 23:55:00 UTC	-300L

Node.js

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixSeconds().as("unixSeconds")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("dateString").timestampToUnixSeconds().as("unixSeconds")
  )
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("dateString").timestampToUnixSeconds().as("unixSeconds")
  ])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixSeconds().alias("unixSeconds")
    )
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("dateString").timestampToUnixSeconds().alias("unixSeconds")
    )
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(Field.of("dateString").timestamp_to_unix_seconds().as_("unixSeconds"))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(timestampToUnixSeconds(field("dateString")).as("unixSeconds"))
        .execute()
        .get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("documents").
	Select(firestore.Fields(
		firestore.TimestampToUnixSeconds(firestore.FieldOf("dateString")).As("unixSeconds"),
	)).
	Execute(ctx)pipeline_snippets_date_timestamp.go

TIMESTAMP_DIFF

Syntaxe :

timestamp_diff(end: TIMESTAMP | BSON_TIMESTAMP, start: TIMESTAMP | BSON_TIMESTAMP, unit: STRING) -> INT64

Description :

Renvoie le nombre entier d'intervalles unit spécifiés entre deux TIMESTAMP.

Renvoie une valeur négative si end est antérieur à start.
Tronque toute unité fractionnaire. Par exemple, timestamp_diff("2021-01-01 00:00:01", "2021-01-01 00:00:00", "minute") renvoie 0.

L'argument unit doit être une chaîne et l'un des éléments suivants :

microsecond
millisecond
second
minute
hour
day

Exemples :

`end`	`start`	`unit`	`timestamp_diff(end, start, unit)`
2026-07-04 00:01:00 UTC	2026-07-04 00:00:00 UTC	"second"	60L
2026-07-04 00:00:00 UTC	2026-07-05 00:00:00 UTC	"day"	-1L
2026-07-04 00:00:59 UTC	2026-07-04 00:00:00 UTC	"minute"	0L

TIMESTAMP_EXTRACT

Syntaxe :

timestamp_extract(timestamp: TIMESTAMP | BSON_TIMESTAMP, part: STRING[, timezone: STRING]) -> INT64

Description :

Extrait un part spécifique (par exemple, l'année, le mois ou le jour) de timestamp.

L'argument part doit être une chaîne et l'un des éléments suivants :

microsecond
millisecond
second
minute
hour
day
dayofweek : renvoie une valeur comprise entre 1 (dimanche) et 7 (samedi).
dayofyear
week : renvoie le numéro de la semaine dans l'année, en commençant par 1 pour le premier dimanche de l'année.
week([weekday]) : renvoie le numéro de semaine de l'année, en commençant par le weekday spécifié.
month
quarter
year
isoweek : renvoie le numéro de semaine ISO 8601.
isoyear : renvoie l'année à numérotation de semaine ISO 8601.

Si l'argument timezone est fourni, l'extraction sera basée sur le calendrier du fuseau horaire donné. L'extraction respectera l'heure d'été.

Si timezone n'est pas fourni, l'extraction sera basée sur UTC.

L'argument timezone doit être une représentation sous forme de chaîne d'un fuseau horaire de la base de données des fuseaux horaires, par exemple America/New_York. Vous pouvez également utiliser un horodatage personnalisé en spécifiant un décalage par rapport à GMT.

Exemples :

`timestamp`	`part`	`timezone`	`timestamp_extract(timestamp, part, timezone)`
2025-02-20 10:20:30 UTC	"year"	Non fourni	2025
2025-02-20 10:20:30 UTC	"day"	Non fourni	20
2025-12-31 23:59:59 UTC	"year"	"Asia/Tokyo"	2026

Étapes suivantes

Consultez la présentation des requêtes de pipeline.

Documentation de référence sur les fonctions d'horodatage

Fonctions de code temporel

CURRENT_TIMESTAMP

TIMESTAMP_TRUNC

UNIX_MICROS_TO_TIMESTAMP

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

UNIX_MILLIS_TO_TIMESTAMP

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

UNIX_SECONDS_TO_TIMESTAMP

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_ADD

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_SUB

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_TO_UNIX_MICROS

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_TO_UNIX_MILLIS

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_TO_UNIX_SECONDS

Node.js

Web

Swift

KotlinAndroid

JavaAndroid

Python

Java

Go

TIMESTAMP_DIFF

TIMESTAMP_EXTRACT

Étapes suivantes

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android

Java
Android