Navigation
POST datetime

add_subtract

1 credit

Add or subtract a given amount of time from a date and return the resulting ISO 8601 date.

Endpoint

POST /api/v1/tools/datetime/add_subtract

Body Parameters

unit string optional default: "days"
Options: days hours minutes seconds
amount integer required
operation string optional default: "add"
Options: add subtract
date_string string required

Example

input Request 
{
    "unit": "days",
    "amount": 7,
    "operation": "add",
    "date_string": "2024-01-15T10:30:00"
}
output Response 
{
    "iso": "2024-01-22T10:30:00"
}

Response Format

HTTP/1.1 200 OK SUCCESS 
{
  "success": true,
  "data": {
    "iso": "2024-01-22T10:30:00"
},
  "meta": {
    "tool": "add_subtract",
    "credits_consumed": 1
  }
}
HTTP/1.1 422 Unprocessable Entity ERROR 
{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid."
  }
}

Sign in to try this tool directly from the docs.

Code Examples
Request Example
lightbulb Developer Tip

Credits are deducted before execution. If the upstream tool fails, credits are automatically refunded to your account.