DateTimeTask

The DateTimeTask node generates the current date and time, with optional adjustments and formatting. It is typically used to compute dynamic timestamps for logging, scheduling, or data formatting within your automation workflow.

---

🧩 Node Type

• Category: Task
• TaskType: DateTimeTask
• Icon: mdi mdi-calendar-clock
• Outputs:
  • DateTimeObject: The calculated DateTime value.
  • StringFormattedDate: The string representation of the date (if formatting is specified).

---

⚙️ Inputs

Label	Type	Description	Required	Visible When
Adjust Now Date	picklist	The unit to adjust the current date/time by.	No	Always
Number to Adjust by	text	The number of units to adjust the current date by.	No	When Adjust Now Date is specified
String Formatted Date	text	A .NET format string to convert the date to a formatted string.	No	Always
Output Variable Name	text	The variable name to store the formatted date string.	No	Always

---

🔽 Options for "Adjust Now Date"

Option	Description
Add Years	Adds the specified number of years
AddMonths	Adds the specified number of months
Add Days	Adds the specified number of days
Add Hours	Adds the specified number of hours
Add Minutes	Adds the specified number of minutes
Add Seconds	Adds the specified number of seconds
Add Milliseconds	Adds the specified number of milliseconds

---

🧪 Example Configuration

• Adjust Now Date: Add Days
• Number to Adjust by: 2
• String Formatted Date: yyyy-MM-dd
• Output Variable Name: myDate

Resulting output:

• DateTimeObject: The current date + 2 days (as a DateTime object)
• StringFormattedDate: A string like 2025-06-20

---

✅ Output

Key	Type	Description
DateTimeObject	DateTime	The calculated DateTime, with adjustment applied if needed.
StringFormattedDate	string	The string representation of the date, if format is provided.

---

⚠️ Notes

• If no adjustment is provided, the task uses the current system time (DateTime.Now).
• The .NET date format string must be valid or the task will fail.
• Reference: .NET custom date format strings

---

🚫 Errors

This node may return Fail in the following cases:

• No user inputs provided.
• The date format string is invalid.
• An unhandled exception occurs during execution.

---

🧱 Implementation Notes

• Namespace: MinuteView_Automations.Tasks.Actions.Utilities
• Class: DateTimeTask : BaseTask
• Uses DateTime.Now as the starting point.
• Adjusts the date based on selected unit and input value.
• Supports string formatting using standard .NET format codes.