原生模式下的 Cloud Firestore 企业版现已推出！了解详情。

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

تابع‌های مُهر زمان

توابع مُهر زمان

نام	شرح
`CURRENT_TIMESTAMP`	`TIMESTAMP` مربوط به زمان درخواست را تولید می‌کند.
`TIMESTAMP_TRUNC`	`TIMESTAMP` را به دانه‌بندی مشخصی کوتاه می‌کند.
`UNIX_MICROS_TO_TIMESTAMP`	تعداد میکروثانیه‌ها را از `1970-01-01 00:00:00 UTC` به `TIMESTAMP` تبدیل می‌کند
`UNIX_MILLIS_TO_TIMESTAMP`	تعداد میلی‌ثانیه‌ها از `1970-01-01 00:00:00 UTC` را به `TIMESTAMP` تبدیل می‌کند
`UNIX_SECONDS_TO_TIMESTAMP`	تعداد ثانیه‌ها از `1970-01-01 00:00:00 UTC` را به `TIMESTAMP` تبدیل می‌کند
`TIMESTAMP_ADD`	بازه زمانی به `TIMESTAMP` اضافه می‌کند
`TIMESTAMP_SUB`	بازه زمانی را از `TIMESTAMP` کم می‌کند
`TIMESTAMP_TO_UNIX_MICROS`	`TIMESTAMP` را به تعداد میکروثانیه‌ها از `1970-01-01 00:00:00 UTC` تبدیل می‌کند
`TIMESTAMP_TO_UNIX_MILLIS`	`TIMESTAMP` را به تعداد میلی‌ثانیه‌ها از `1970-01-01 00:00:00 UTC` تبدیل می‌کند
`TIMESTAMP_TO_UNIX_SECONDS`	‫`TIMESTAMP` را به تعداد ثانیه‌ها از `1970-01-01 00:00:00 UTC` تبدیل می‌کند
`TIMESTAMP_DIFF`	عدد کامل فواصل `unit` مشخص‌شده بین دو `TIMESTAMP` را برمی‌گرداند.
`TIMESTAMP_EXTRACT`	`part` خاصی (مثلاً سال، ماه، روز) را از `TIMESTAMP` استخراج می‌کند.

CURRENT_TIMESTAMP

نحو:

current_timestamp() -> TIMESTAMP

شرح:

مُهر زمان را در ابتدای زمان درخواست input دریافت می‌کند (به‌عنوان تعداد میکروثانیه‌ها از 1970-01-01 00:00:00 UTC تفسیر می‌شود).

این مقدار در یک پُرسمان ثابت است و اگر چندین بار فراخوانی شود، همیشه به همان مقدار حل می‌شود.

TIMESTAMP_TRUNC

نحو:

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

شرح:

مُهر زمان را تا دانه‌بندی مشخصی کوتاه می‌کند.

آرگومان granularity باید رشته و یکی از موارد زیر باشد:

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

اگر آرگومان timezone ارائه شود، کوتاه کردن براساس مرزهای تقویم منطقه زمانی ارائه‌شده انجام خواهد شد (برای مثال، کوتاه کردن روز به نیمه‌شب در منطقه زمانی ارائه‌شده کوتاه خواهد شد). این کوتاه کردن ساعت تابستانی را رعایت خواهد کرد.

اگر timezone ارائه نشده باشد، کوتاه کردن براساس مرزهای تقویم UTC خواهد بود.

متغیر مستقل timezone باید رشته‌ای باشد که نشان‌دهنده منطقه زمانی از پایگاه داده tz باشد، برای مثال America/New_York. با مشخص کردن یک انحراف از GMT، می‌توان از یک انحراف زمانی سفارشی نیز استفاده کرد.

نمونه:

`timestamp`	`granularity`	`timezone`	`timestamp_trunc(timestamp, granularity, timezone)`
2000-01-01 10:20:30:123456 UTC	«ثانیه»	ارائه نشده است	‫2001-01-01 10:20:30 UTC
‫1997-05-31 04:30:30 UTC	«روز»	ارائه نشده است	‫1997-05-31 00:00:00 UTC
‫1997-05-31 04:30:30 UTC	«روز»	"America/Los_Angeles"	‫1997-05-30 07:00:00 UTC
‫2001-03-16 04:00:00 UTC	"week(friday)	ارائه نشده است	‫2001-03-16 00:00:00 UTC
‫۲۰۰۱-۰۳-۲۳ ۰۴:۰۰:۰۰ ساعت هماهنگ جهانی	"week(friday)	"America/Los_Angeles"	‫2001-03-23 17:00:00 UTC
‫۲۰۲۶-۰۱-۲۴ ۲۰:۰۰:۰۰ ساعت هماهنگ جهانی	«ماه»	«GMT+06:32:43»	‫2026-01-01T06:32:43 UTC

UNIX_MICROS_TO_TIMESTAMP

نحو:

unix_micros_to_timestamp(input: INT64) -> TIMESTAMP

شرح:

‫input (تفسیرشده به‌عنوان تعداد میکروثانیه‌ها از 1970-01-01 00:00:00 UTC) را به TIMESTAMP تبدیل می‌کند. اگر input نتواند به TIMESTAMP معتبری تبدیل شود، error را برمی‌گرداند.

نمونه:

`input`	`unix_micros_to_timestamp(input)`
‫۰ لیتر	‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ UTC
400123456L	‫1970-01-01 00:06:40.123456 UTC
-1000000L	‫۱۹۶۹-۱۲-۳۱ ۲۳:۵۹:۵۹ به‌وقت ساعت هماهنگ جهانی

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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

unix_millis_to_timestamp(input: INT64) -> TIMESTAMP

شرح:

‫input (به‌عنوان تعداد میلی‌ثانیه‌ها از 1970-01-01 00:00:00 UTC تفسیر می‌شود) را به TIMESTAMP تبدیل می‌کند. اگر input نتواند به TIMESTAMP معتبری تبدیل شود، error را برمی‌گرداند.

نمونه:

`input`	`unix_millis_to_timestamp(input)`
‫۰ لیتر	‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ 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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

unix_seconds_to_timestamp(input: INT64) -> TIMESTAMP

شرح:

‫input (به‌عنوان تعداد ثانیه‌ها از 1970-01-01 00:00:00 UTC تفسیر می‌شود) را به TIMESTAMP تبدیل می‌کند. اگر input نتواند به TIMESTAMP معتبری تبدیل شود، error را برمی‌گرداند.

نمونه:

`input`	`unix_seconds_to_timestamp(input)`
‫۰ لیتر	‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ UTC
۶۰ لیتر	‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۱:۰۰ به‌وقت ساعت هماهنگ جهانی
-300L	‫۱۹۶۹-۱۲-۳۱ ۲۳:۵۵:۰۰ ساعت هماهنگ جهانی

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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

TIMESTAMP_ADD

نحو:

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

شرح:

amount از unit را از timestamp اضافه می‌کند. آرگومان amount می‌تواند منفی باشد، دراین‌صورت معادل TIMESTAMP_SUB است.

آرگومان unit باید رشته و یکی از موارد زیر باشد:

microsecond
millisecond
second
minute
hour
day

اگر مُهر زمان حاصل در محدوده TIMESTAMP قرار نگیرد، خطا ایجاد می‌کند.

نمونه:

`timestamp`	`unit`	`amount`	`timestamp_add(timestamp, unit, amount)`
‫۲۰۲۵-۰۲-۲۰ ۰۰:۰۰:۰۰ ساعت هماهنگ جهانی	«دقیقه»	2L	‫۲۰۲۵-۰۲-۲۰ ۰۰:۰۲:۰۰ 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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

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

شرح:

amount از unit را از timestamp کم می‌کند. آرگومان amount می‌تواند منفی باشد، دراین‌صورت معادل TIMESTAMP_ADD است.

آرگومان unit باید رشته و یکی از موارد زیر باشد:

microsecond
millisecond
second
minute
hour
day

اگر مُهر زمان حاصل در محدوده TIMESTAMP قرار نگیرد، خطا ایجاد می‌کند.

نمونه:

`timestamp`	`unit`	`amount`	`timestamp_sub(timestamp, unit, amount)`
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	«دقیقه»	‫۴۰ لیتر	‫2026-07-03 23:20:00 UTC
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	«ساعت»	‫-۲۴ لیتر	‫۲۰۲۶-۰۷-۰۵ ۰۰:۰۰:۰۰ ساعت هماهنگ جهانی
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	«روز»	3L	‫۲۰۲۶-۰۷-۰۱ ۰۰:۰۰:۰۰ 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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

timestamp_to_unix_micros(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

شرح:

input را به تعداد میکروثانیه‌ها از 1970-01-01 00:00:00 UTC تبدیل می‌کند. با گرد کردن به پایین تا ابتدای میکروثانیه، سطوح بالاتر دقت را کوتاه می‌کند.

نمونه:

`input`	`timestamp_to_unix_micros(input)`
‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ UTC	‫۰ لیتر
‫1970-01-01 00:06:40.123456 UTC	400123456L
‫۱۹۶۹-۱۲-۳۱ ۲۳:۵۹:۵۹ به‌وقت ساعت هماهنگ جهانی	-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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

timestamp_to_unix_millis(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

شرح:

input را به تعداد میلی‌ثانیه‌ها از 1970-01-01 00:00:00 UTC تبدیل می‌کند. با گرد کردن به پایین تا ابتدای میلی‌ثانیه، سطوح بالاتر دقت را کوتاه می‌کند.

نمونه:

`input`	`timestamp_to_unix_millis(input)`
‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ UTC	‫۰ لیتر
‫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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

نحو:

timestamp_to_unix_seconds(input: TIMESTAMP | BSON_TIMESTAMP) -> INT64

شرح:

‫input را به تعداد ثانیه‌ها از 1970-01-01 00:00:00 UTC تبدیل می‌کند. با گرد کردن به پایین تا ابتدای ثانیه، سطوح بالاتر دقت را کوتاه می‌کند.

نمونه:

`input`	`timestamp_to_unix_seconds(input)`
‫۱۹۷۰-۰۱-۰۱ ۰۰:۰۰:۰۰ 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

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

Java

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

پایتون

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

جاوا

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

رفتن

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

TIMESTAMP_DIFF

نحو:

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

شرح:

عدد کامل فواصل unit مشخص‌شده بین دو TIMESTAMP را برمی‌گرداند.

اگر end قبل‌از start باشد، مقدار منفی برمی‌گرداند.
هر واحد کسری را کوتاه می‌کند. برای مثال، timestamp_diff("2021-01-01 00:00:01", "2021-01-01 00:00:00", "minute") مقدار 0 را برمی‌گرداند.

آرگومان unit باید رشته و یکی از موارد زیر باشد:

microsecond
millisecond
second
minute
hour
day

نمونه:

`end`	`start`	`unit`	`timestamp_diff(end, start, unit)`
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۱:۰۰ UTC	‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	«ثانیه»	۶۰ لیتر
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	‫۲۰۲۶-۰۷-۰۵ ۰۰:۰۰:۰۰ ساعت هماهنگ جهانی	«روز»	‫-۱ لیتر
‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۵۹ به‌وقت ساعت هماهنگ جهانی	‫۲۰۲۶-۰۷-۰۴ ۰۰:۰۰:۰۰ UTC	«دقیقه»	‫۰ لیتر

TIMESTAMP_EXTRACT

نحو:

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

شرح:

part خاصی (مثلاً سال، ماه، روز) را از timestamp استخراج می‌کند.

آرگومان part باید رشته و یکی از موارد زیر باشد:

microsecond
millisecond
second
minute
hour
day
dayofweek: مقداری بین ۱ (یکشنبه) و ۷ (شنبه) برمی‌گرداند.
dayofyear
week: شماره هفته سال را برمی‌گرداند، که از ۱ برای اولین یکشنبه سال شروع می‌شود.
week([weekday]): شماره هفته سال را با شروع از weekday مشخص‌شده برمی‌گرداند.
month
quarter
year
‫isoweek: شماره هفته ISO 8601 را برمی‌گرداند.
isoyear: سال شماره‌گذاری هفته ISO 8601 را برمی‌گرداند.

اگر آرگومان timezone ارائه شود، استخراج براساس تقویم منطقه زمانی ارائه‌شده خواهد بود. استخراج از ساعت تابستانی تبعیت خواهد کرد.

اگر timezone ارائه نشود، استخراج براساس UTC انجام خواهد شد.

متغیر مستقل timezone باید نمایشی رشته‌ای از منطقه زمانی از پایگاه داده منطقه زمانی باشد، برای مثال America/New_York. با مشخص کردن یک انحراف از GMT، می‌توان از یک انحراف زمانی سفارشی نیز استفاده کرد.

نمونه:

`timestamp`	`part`	`timezone`	`timestamp_extract(timestamp, part, timezone)`
2025-02-20 10:20:30 UTC	"year"	ارائه نشده است	۲۰۲۵
2025-02-20 10:20:30 UTC	«روز»	ارائه نشده است	20
‫۲۰۲۵-۱۲-۳۱ ساعت ۲۳:۵۹:۵۹ به‌وقت ساعت هماهنگ جهانی	"year"	«آسیا/توکیو»	2026

تابع‌های مُهر زمان با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

توابع مُهر زمان

CURRENT_TIMESTAMP

TIMESTAMP_TRUNC

UNIX_MICROS_TO_TIMESTAMP

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

UNIX_MILLIS_TO_TIMESTAMP

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

UNIX_SECONDS_TO_TIMESTAMP

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_ADD

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_SUB

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_TO_UNIX_MICROS

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_TO_UNIX_MILLIS

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_TO_UNIX_SECONDS

Node.js

Web

Swift

Kotlin

Java

پایتون

جاوا

رفتن

TIMESTAMP_DIFF

TIMESTAMP_EXTRACT

تابع‌های مُهر زمان