Categories

← View All Tools

Date Adder

Add or subtract time periods from a date (years, months, days, hours, minutes, seconds)

Key Facts

Category
Utilities
Input Types
text, number, select, checkbox
Output Type
json
Sample Coverage
4
API Ready
Yes

Overview

The Date Adder is a precise utility tool designed to calculate future or past dates by adding or subtracting specific time intervals, including years, months, days, hours, minutes, and seconds.

When to Use

  • •Determining project deadlines or delivery dates based on a specific duration.
  • •Calculating historical timestamps for log analysis or data reconciliation.
  • •Adjusting scheduling events when shifting time zones or planning recurring appointments.

How It Works

  • •Enter your starting date and time in the required format.
  • •Input the specific number of years, months, days, hours, minutes, or seconds you wish to modify.
  • •Select whether to add or subtract the duration from the base date.
  • •Choose your preferred output format and click calculate to generate the result.

Use Cases

Project Management: Calculating exact completion dates by adding a specific number of working days to a project start date.
Financial Reporting: Determining the maturity date of an investment by adding a set number of months to the purchase date.
System Administration: Calculating the expiration timestamp of a temporary access token by adding minutes to the current time.

Examples

1. Project Deadline Calculation

Project Manager
Background
A project starts on January 15, 2024, and requires a 45-day development phase.
Problem
Quickly determine the exact end date for the project schedule.
How to Use
Enter '2024-01-15' as the start date, set 'Days' to 45, and select 'Add'.
Example Config
startDate: 2024-01-15, days: 45, operation: add, format: date
Outcome
The tool returns '2024-02-29', accounting for the leap year.

2. Token Expiration Time

Software Developer
Background
An API authentication token is generated at 14:30:00 and is valid for 3600 seconds.
Problem
Calculate the exact expiration time for the token.
How to Use
Enter the current time, set 'Seconds' to 3600, and select 'Add'.
Example Config
startDate: 2024-01-15T14:30:00, seconds: 3600, operation: add, format: time
Outcome
The tool returns '15:30:00'.

Try with Samples

utilities
Windows Date and Time - C# Samples
Comprehensive C# date and time processing examples for Windows platform including DateTime, TimeSpan, TimeZone, and calendar operations
title token date
sample
macOS Date Time Objective-C Samples
macOS Objective-C date and time examples including NSDate, NSDateFormatter, NSCalendar, and time intervals
title token date
sample
Text with Date Samples
Text containing various date formats for testing date extraction and parsing
title token date
sample
Web Date & Time Python Samples
Web Python date and time examples including getting current time, formatting, parsing, and timezone operations
title token date
sample

Related Hubs

Utilities Convert Tools
Explore 10 utilities tools for convert workflows and compare closely related utilities quickly.
Json Convert Tools
Explore 100 json tools for convert workflows and compare closely related utilities quickly.
Image Convert Tools
Explore 100 image tools for convert workflows and compare closely related utilities quickly.
Audio Convert Tools
Explore 100 audio tools for convert workflows and compare closely related utilities quickly.

FAQ

Can I subtract time using this tool?

Yes, simply select the 'Subtract (-)' option from the operation dropdown menu.

What date formats are supported?

The tool accepts standard ISO 8601 formats and common YYYY-MM-DD HH:MM:SS date-time strings.

Does this tool account for leap years?

Yes, the calculation engine automatically adjusts for leap years and varying month lengths.

Can I get the output in a specific format?

Yes, you can choose from several output formats including ISO 8601, Date Only, Time Only, or a friendly readable format.

Is there a limit to the time I can add?

The tool supports a wide range of inputs, allowing you to calculate offsets spanning up to 100 years or millions of seconds.

API Documentation

Request Endpoint

POST /en/api/tools/date-adder

Request Parameters

Parameter Name Type Required Description
startDate text Yes -
years number No -
months number No -
days number No -
hours number No -
minutes number No -
seconds number No -
operation select No -
format select No -
includeBusinessDays checkbox No -

Response Format

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
JSON Data: JSON Data

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-date-adder": {
      "name": "date-adder",
      "description": "Add or subtract time periods from a date (years, months, days, hours, minutes, seconds)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=date-adder",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

If you encounter any issues, please contact us at [email protected]