Server timestamps in Firebase - Mini Project: Build & Apply

Server timestamps

📖 Scenario: You are building a simple chat app using Firebase. Each message needs to have a timestamp showing when it was sent. To keep the time consistent for all users, you want to use Firebase's server timestamp feature instead of the user's device time.

🎯 Goal: Create a Firebase Firestore document for a chat message that includes a server-generated timestamp.

📋 What You'll Learn

Create a dictionary called message with a text field set to 'Hello, Firebase!'.

Add a field called timestamp using Firebase's server timestamp placeholder.

Write code to add the message dictionary to a Firestore collection called messages.

Ensure the timestamp uses Firebase's server time, not the client device time.

💡 Why This Matters

🌍 Real World

Using server timestamps ensures all chat messages have consistent and trustworthy time data regardless of user device clocks.

💼 Career

Understanding server timestamps is essential for backend consistency in cloud applications, especially in real-time databases and messaging apps.

1

Create the message dictionary

Create a dictionary called message with a key text and value 'Hello, Firebase!'.

Firebase

# Create the message dictionary with text
# Your code here

Hint

Use curly braces to create a dictionary and set the key 'text' to the string 'Hello, Firebase!'.

2

Import Firebase server timestamp

Import firestore from firebase_admin and assign firestore.SERVER_TIMESTAMP to a variable called timestamp.

Firebase

message = {'text': 'Hello, Firebase!'}
# Import firestore from firebase_admin and assign SERVER_TIMESTAMP to timestamp
# Your code here

Hint

Use firestore.SERVER_TIMESTAMP to get the server timestamp sentinel value.

3

Add timestamp to message dictionary

Add a key timestamp to the message dictionary and set its value to the variable timestamp.

Firebase

from firebase_admin import firestore

message = {'text': 'Hello, Firebase!'}
timestamp = firestore.SERVER_TIMESTAMP
# Add timestamp to message dictionary
# Your code here

Hint

Use dictionary key assignment to add the timestamp to the message.

4

Add message to Firestore collection

Write code to add the message dictionary to the Firestore collection called messages using db.collection('messages').add(message). Assume db is the Firestore client instance.

Firebase

from firebase_admin import firestore

message = {'text': 'Hello, Firebase!'}
timestamp = firestore.SERVER_TIMESTAMP
message['timestamp'] = timestamp
# Add message to Firestore collection 'messages'
# Your code here

Hint

Use the Firestore client db to add the message to the 'messages' collection.

Practice

1. What is the main purpose of using firebase.firestore.FieldValue.serverTimestamp() in Firestore?

easy

A. To get the current time from the user's device

B. To store the exact time from the server when the data is written

C. To create a random timestamp for testing

D. To convert a timestamp to a readable string

Solution

1. Step 1: Understand server timestamp usage

   The method serverTimestamp() sets the field to the current time according to the server, not the client device.

2. Step 2: Compare with other options

   Options B, C, and D do not describe server-based time storage. Only To store the exact time from the server when the data is written correctly describes storing server time when data is written.

3. Final Answer:

   To store the exact time from the server when the data is written -> Option B

4. Quick Check:

   Server timestamp = accurate server time [OK]

Hint: Server timestamp always uses server time, not client time [OK]

Common Mistakes:

• Thinking it uses client device time
• Confusing with formatting timestamps
• Assuming it generates random times

2. Which of the following is the correct syntax to set a Firestore document field to the server timestamp?

easy

A. docRef.set({ createdAt: firebase.firestore.FieldValue.serverTimestamp() })

B. docRef.set({ createdAt: new Date() })

C. docRef.set({ createdAt: Date.now() })

D. docRef.set({ createdAt: firebase.firestore.Timestamp.now() })

Solution

1. Step 1: Identify correct method for server timestamp

   The correct method to set a server timestamp in Firestore is firebase.firestore.FieldValue.serverTimestamp().

2. Step 2: Check other options for correctness

   docRef.set({ createdAt: new Date() }) uses client time with new Date(). docRef.set({ createdAt: Date.now() }) uses client time with Date.now(). docRef.set({ createdAt: firebase.firestore.Timestamp.now() }) uses current timestamp but from client side. Only docRef.set({ createdAt: firebase.firestore.FieldValue.serverTimestamp() }) uses the server timestamp method.

3. Final Answer:

   docRef.set({ createdAt: firebase.firestore.FieldValue.serverTimestamp() }) -> Option A

4. Quick Check:

   Correct syntax = docRef.set({ createdAt: firebase.firestore.FieldValue.serverTimestamp() }) [OK]

Hint: Use FieldValue.serverTimestamp() to get server time [OK]

Common Mistakes:

• Using client-side Date or Timestamp instead
• Missing firebase.firestore prefix
• Using parentheses incorrectly

3. Consider this Firestore update code:

docRef.update({ lastModified: firebase.firestore.FieldValue.serverTimestamp() });

What will be the value of lastModified immediately after this update on the client side?

medium

A. The client device's current time

B. The exact server timestamp value

C. null until the server confirms the update

D. An error because serverTimestamp() cannot be used in update

Solution

1. Step 1: Understand serverTimestamp behavior on client

   When using serverTimestamp(), Firestore sets the field to null locally until the server responds with the actual timestamp.

2. Step 2: Evaluate options based on this behavior

   The exact server timestamp value is incorrect because the client does not have the exact server time immediately. The client device's current time is wrong because client time is not used. An error because serverTimestamp() cannot be used in update is wrong because serverTimestamp() can be used in update. null until the server confirms the update correctly states the field is null initially.

3. Final Answer:

   null until the server confirms the update -> Option C

4. Quick Check:

   Local value before server response = null [OK]

Hint: Local timestamp is null until server confirms [OK]

Common Mistakes:

• Expecting immediate server time on client
• Confusing update with set behavior
• Assuming client time is used

4. You wrote this Firestore code but get an error:

docRef.set({ createdAt: firebase.firestore.serverTimestamp() });

What is the likely cause of the error?

medium

A. The document reference docRef is undefined

B. Using set instead of update

C. Server timestamps cannot be used in set calls

D. Missing FieldValue in the method call

Solution

1. Step 1: Check the method call syntax

   The correct method to get a server timestamp is firebase.firestore.FieldValue.serverTimestamp(). The code misses FieldValue.

2. Step 2: Verify other options

   Using set instead of update is incorrect because set supports server timestamps. Server timestamps cannot be used in set calls is false for the same reason. The document reference docRef is undefined could cause an error but the question implies a syntax mistake.

3. Final Answer:

   Missing FieldValue in the method call -> Option D

4. Quick Check:

   Correct method includes FieldValue [OK]

Hint: Always include FieldValue before serverTimestamp() [OK]

Common Mistakes:

• Omitting FieldValue in method call
• Confusing set and update restrictions
• Assuming serverTimestamp is a direct method of firestore

5. You want to store a user's last login time using server timestamps but only update it if the new login time is later than the existing one. Which Firestore approach correctly applies this logic?

hard

A. Use a Firestore transaction to read current timestamp and update with serverTimestamp() if newer

B. Read the current timestamp, compare client time, then conditionally update with serverTimestamp()

C. Use serverTimestamp() directly in update() without checks

D. Set the timestamp field with client time and rely on serverTimestamp() fallback

Solution

1. Step 1: Understand conditional update needs

   To update only if the new login time is later, you must read the current value and compare before writing.

2. Step 2: Identify Firestore feature for atomic read-write

   Firestore transactions allow reading a document and conditionally updating it atomically, ensuring no race conditions.

3. Step 3: Evaluate options

   Use serverTimestamp() directly in update() without checks ignores condition. Read the current timestamp, compare client time, then conditionally update with serverTimestamp() uses client time which is unreliable. Set the timestamp field with client time and rely on serverTimestamp() fallback mixes client and server times incorrectly. Use a Firestore transaction to read current timestamp and update with serverTimestamp() if newer correctly uses a transaction with serverTimestamp.

4. Final Answer:

   Use a Firestore transaction to read current timestamp and update with serverTimestamp() if newer -> Option A

5. Quick Check:

   Conditional update needs transaction [OK]

Hint: Use transactions for conditional server timestamp updates [OK]

Common Mistakes:

• Relying on client time for comparisons
• Not using transactions for atomic checks
• Updating without checking existing timestamp