Skip to content
Postman API Testing Tips

How To Send Date In Json Using Postman

API Testing Blog

Sending Dates in JSON using Postman: A Comprehensive Guide

Postman is a powerful tool for API testing, and understanding how to work with dates is essential. This guide will walk you through sending dates in JSON format using Postman, covering various scenarios and providing practical examples.

1. Sending a Date as a String

This is the most common and straightforward approach. Simply format your date as a string in the desired format, then include it in your JSON payload.

Example:

{
  "eventDate": "2023-10-26"
}

Step-by-step Guide:

  1. Create a new request: In Postman, create a new request (e.g., POST, PUT, etc.).
  2. Set the request body: Select “raw” as the body type and choose JSON as the format.
  3. Input the JSON payload: Enter your JSON payload, including the date as a string formatted according to your API requirements.
  4. Send the request: Click “Send” to execute your request.

2. Using ISO 8601 Date Format

ISO 8601 is a standard date and time format often used in APIs. This format provides a consistent representation of dates, making it easier for different systems to interpret them.

Example:

{
  "eventDate": "2023-10-26T11:45:00.000Z"
}

Note:

  • “T” separates the date and time components.
  • “Z” indicates Coordinated Universal Time (UTC).

3. Sending Date Using a Unix Timestamp

Unix timestamps represent a date as a single integer representing the number of seconds elapsed since the Unix epoch (January 1, 1970, at 00:00:00 UTC).

Example:

{
  "eventDate": 1729968000
}

How to:

  • Calculate Unix timestamp: You can use online tools or programming languages to convert a date to a Unix timestamp.
  • Include in JSON: Add the timestamp to your JSON payload as a numeric value.

4. Sending Date in Milliseconds

Similar to Unix timestamps, you can send dates as the number of milliseconds elapsed since the Unix epoch.

Example:

{
  "eventDate": 1729968000000
}

Note:

  • Be sure to multiply the seconds in a Unix timestamp by 1000 to get the equivalent value in milliseconds.

5. Sending Date with Postman’s Prerequest Script

For more complex scenarios, you can use Postman’s Prerequest Script to dynamically generate date values.

Example:

// Create a new Date object
const now = new Date();


// Format the date as ISO 8601
const formattedDate = now.toISOString();


// Set the "eventDate" variable in the environment
pm.environment.set("eventDate", formattedDate);

Steps:

  1. Go to the “Pre-request Script” tab in your Postman request.
  2. Paste the code: Paste the JavaScript code to generate the desired date format.
  3. Send the request: Send your request, and Postman will automatically include the generated date in your JSON payload.

6. Testing with Different Date Formats

While sending a date in JSON using Postman, it’s important to test your API with different date formats to ensure compatibility and prevent unexpected errors.

Example:

  • Test with ISO 8601, Unix timestamp, and other formats that your API might accept.
  • Use different date values (past, present, and future dates to verify the API’s handling of various dates.

Remember: Always consult the API documentation to determine the preferred format and any specific requirements related to date handling. By understanding these principles and utilizing the techniques outlined above, you’ll be equipped to confidently send dates in JSON using Postman for your API testing needs.

API Testing Blog