pict-section-formeditor 1.0.0

package/user-documentation/solverfunctions/dateaddseconds.md

@@ -0,0 +1,66 @@
+# dateaddseconds
+
+Adds a specified number of seconds to a date.
+
+## Syntax
+
+```
+dateaddseconds(date, seconds)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `date` | String | Starting date (ISO 8601 format) |
+| `seconds` | Number | Number of seconds to add (can be negative) |
+
+## Returns
+
+String - The resulting date in ISO 8601 format.
+
+## Description
+
+The `dateaddseconds` function adds a specified number of seconds to a date and returns the new date/time. Use negative numbers to subtract seconds.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEADDSECONDS("2025-04-01T10:30:00.000Z", 30)
+// Result: "2025-04-01T10:30:30.000Z"
+```
+
+### Subtracting Seconds
+
+```expression
+Result = DATEADDSECONDS("2025-04-01T10:30:30.000Z", -15)
+// Result: "2025-04-01T10:30:15.000Z"
+```
+
+### Timeout Calculation
+
+```expression
+TimeoutExpiry = DATEADDSECONDS(RequestTime, TimeoutSeconds)
+```
+
+## Use Cases
+
+- **Timeouts**: Calculate expiry times
+- **Animations**: Timing calculations
+- **Performance**: Measure durations
+- **Precision timing**: Second-level calculations
+
+## Related Functions
+
+- [dateaddmilliseconds](./dateaddmilliseconds.md) - Add milliseconds
+- [dateaddminutes](./dateaddminutes.md) - Add minutes
+- [dateseconddifference](./dateseconddifference.md) - Calculate second difference
+
+## Notes
+
+- Returns ISO 8601 formatted string
+- Handles minute/hour boundaries
+- Negative values subtract seconds
+- Uses the Dates service internally

package/user-documentation/solverfunctions/dateaddweeks.md

@@ -0,0 +1,73 @@
+# dateaddweeks
+
+Adds a specified number of weeks to a date.
+
+## Syntax
+
+```
+dateaddweeks(date, weeks)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `date` | String | Starting date (ISO 8601 format) |
+| `weeks` | Number | Number of weeks to add (can be negative) |
+
+## Returns
+
+String - The resulting date in ISO 8601 format.
+
+## Description
+
+The `dateaddweeks` function adds a specified number of weeks to a date and returns the new date. Use negative numbers to subtract weeks.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEADDWEEKS("2025-04-01T00:00:00.000Z", 2)
+// Result: "2025-04-15T00:00:00.000Z"
+```
+
+### Subtracting Weeks
+
+```expression
+Result = DATEADDWEEKS("2025-04-15T00:00:00.000Z", -1)
+// Result: "2025-04-08T00:00:00.000Z"
+```
+
+### Sprint Planning
+
+```expression
+SprintEndDate = DATEADDWEEKS(SprintStartDate, 2)
+```
+
+### Weekly Schedule
+
+```expression
+NextMeeting = DATEADDWEEKS(LastMeeting, 1)
+```
+
+## Use Cases
+
+- **Sprint planning**: Calculate sprint dates
+- **Scheduling**: Weekly recurring events
+- **Project management**: Week-based milestones
+- **Payroll**: Bi-weekly pay periods
+
+## Related Functions
+
+- [dateadddays](./dateadddays.md) - Add days
+- [dateaddmonths](./dateaddmonths.md) - Add months
+- [dateweekdifference](./dateweekdifference.md) - Calculate week difference
+- [datefromparts](./datefromparts.md) - Create date from parts
+
+## Notes
+
+- Returns ISO 8601 formatted string
+- One week equals 7 days
+- Negative values subtract weeks
+- Uses the Dates service internally

package/user-documentation/solverfunctions/dateaddyears.md

@@ -0,0 +1,74 @@
+# dateaddyears
+
+Adds a specified number of years to a date.
+
+## Syntax
+
+```
+dateaddyears(date, years)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `date` | String | Starting date (ISO 8601 format) |
+| `years` | Number | Number of years to add (can be negative) |
+
+## Returns
+
+String - The resulting date in ISO 8601 format.
+
+## Description
+
+The `dateaddyears` function adds a specified number of years to a date and returns the new date. Use negative numbers to subtract years.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEADDYEARS("2025-04-15T00:00:00.000Z", 5)
+// Result: "2030-04-15T00:00:00.000Z"
+```
+
+### Subtracting Years
+
+```expression
+Result = DATEADDYEARS("2025-04-15T00:00:00.000Z", -10)
+// Result: "2015-04-15T00:00:00.000Z"
+```
+
+### With Variables
+
+```expression
+ExpirationDate = DATEADDYEARS(IssueDate, ValidityPeriod)
+```
+
+### Age Calculation
+
+```expression
+// Calculate future age date
+FutureDate = DATEADDYEARS(BirthDate, 18)
+```
+
+## Use Cases
+
+- **Contracts**: Multi-year contract expiration
+- **Warranties**: Long-term warranty dates
+- **Planning**: Long-term projections
+- **Legal**: Statute of limitations
+
+## Related Functions
+
+- [dateadddays](./dateadddays.md) - Add days
+- [dateaddmonths](./dateaddmonths.md) - Add months
+- [dateyeardifference](./dateyeardifference.md) - Calculate year difference
+- [datefromparts](./datefromparts.md) - Create date from parts
+
+## Notes
+
+- Returns ISO 8601 formatted string
+- Handles leap years appropriately
+- Negative values subtract years
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datedaydifference.md

@@ -0,0 +1,84 @@
+# datedaydifference
+
+Calculates the difference between two dates in days.
+
+## Syntax
+
+```
+datedaydifference(startDate, endDate)
+datedaydifference(startDate, endDate, requireEndDate)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | String | Start date (ISO 8601 format) |
+| `endDate` | String | End date (ISO 8601 format) |
+| `requireEndDate` | Number | If 1, returns NaN when endDate is missing |
+
+## Returns
+
+String - The number of days between the two dates. Negative if endDate is before startDate.
+
+## Description
+
+The `datedaydifference` function calculates how many days have elapsed between two dates. The result is positive when endDate is after startDate, and negative otherwise.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = datedaydifference("2023-08-10T05:00:00.000Z", "2023-08-11T05:00:00.000Z")
+// Result: "1"
+```
+
+### With Variables
+
+```expression
+Result = datedaydifference(StartDate, EndDate)
+// With StartDate = "2023-08-10T05:00:00.000Z", EndDate = "2023-08-11T05:00:00.000Z"
+// Result: "1"
+```
+
+### Negative Result
+
+```expression
+// When end date is before start date
+Result = datedaydifference("2023-08-15T05:00:00.000Z", "2023-08-10T05:00:00.000Z")
+// Result: "-5"
+```
+
+### Requiring End Date
+
+```expression
+// Returns NaN if end date is missing when required
+Result = datedaydifference(StartDate, EndDate, 1)
+// With EndDate undefined
+// Result: "NaN"
+```
+
+## Use Cases
+
+- **Age calculation**: Days since birth or event
+- **Project tracking**: Days until deadline
+- **Billing**: Calculate billing periods
+- **SLA monitoring**: Days since ticket opened
+
+## Related Functions
+
+- [datemilliseconddifference](./datemilliseconddifference.md) - Difference in milliseconds
+- [dateseconddifference](./dateseconddifference.md) - Difference in seconds
+- [dateminutedifference](./dateminutedifference.md) - Difference in minutes
+- [datehourdifference](./datehourdifference.md) - Difference in hours
+- [dateweekdifference](./dateweekdifference.md) - Difference in weeks
+- [datemonthdifference](./datemonthdifference.md) - Difference in months
+- [dateyeardifference](./dateyeardifference.md) - Difference in years
+- [dateadddays](./dateadddays.md) - Add days to a date
+
+## Notes
+
+- Uses ISO 8601 date format
+- Result can be negative
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datefromparts.md

@@ -0,0 +1,81 @@
+# datefromparts
+
+Creates a date from individual year, month, day (and optionally time) components.
+
+## Syntax
+
+```
+datefromparts(year, month, day)
+datefromparts(year, month, day, hour, minute, second, millisecond)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `year` | Number | Four-digit year |
+| `month` | Number | Month (1-12) |
+| `day` | Number | Day of month (1-31) |
+| `hour` | Number | Hour (0-23), optional |
+| `minute` | Number | Minute (0-59), optional |
+| `second` | Number | Second (0-59), optional |
+| `millisecond` | Number | Millisecond (0-999), optional |
+
+## Returns
+
+String - An ISO 8601 formatted date string.
+
+## Description
+
+The `datefromparts` function constructs a date from individual components. This is useful when you have date parts stored separately or need to build a specific date programmatically.
+
+## Examples
+
+### Date Only
+
+```expression
+DateFromPartsExample = DATEFROMPARTS(2025, 4, 1)
+// Result: "2025-04-01T00:00:00.000Z"
+```
+
+### With Time Components
+
+```expression
+DateFromPartsExample = DATEFROMPARTS(2025, 4, 1, 13, 03, 51, 761)
+// Result: "2025-04-01T13:03:51.761Z"
+```
+
+### Combined with Date Math
+
+```expression
+// Create a date then add days
+FutureDate = DATEADDDAYS(DATEFROMPARTS(2025, 4, 1, 13, 03, 51, 761), 87)
+// Result: "2025-06-27T13:03:51.761Z"
+```
+
+### With Variables
+
+```expression
+EventDate = DATEFROMPARTS(EventYear, EventMonth, EventDay)
+```
+
+## Use Cases
+
+- **Form processing**: Build dates from separate input fields
+- **Report generation**: Create specific dates for reports
+- **Data migration**: Convert separate date columns to dates
+- **Scheduling**: Construct dates for calendar events
+
+## Related Functions
+
+- [dateadddays](./dateadddays.md) - Add days to a date
+- [dateaddmonths](./dateaddmonths.md) - Add months to a date
+- [dateaddyears](./dateaddyears.md) - Add years to a date
+- [datedaydifference](./datedaydifference.md) - Calculate day difference
+
+## Notes
+
+- Month is 1-based (January = 1, December = 12)
+- Returns ISO 8601 formatted string (UTC)
+- Time components default to 0 if not provided
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datehourdifference.md

@@ -0,0 +1,64 @@
+# datehourdifference
+
+Calculates the difference between two dates in hours.
+
+## Syntax
+
+```
+datehourdifference(startDate, endDate)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | String | Start date (ISO 8601 format) |
+| `endDate` | String | End date (ISO 8601 format) |
+
+## Returns
+
+String - The number of hours between the two dates.
+
+## Description
+
+The `datehourdifference` function calculates how many hours have elapsed between two dates. The result is positive when endDate is after startDate, and negative otherwise.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEHOURDIFFERENCE("2025-04-01T08:00:00.000Z", "2025-04-01T17:00:00.000Z")
+// Result: "9"
+```
+
+### SLA Tracking
+
+```expression
+HoursSinceCreated = DATEHOURDIFFERENCE(TicketCreated, Now)
+```
+
+### Work Hours
+
+```expression
+HoursWorked = DATEHOURDIFFERENCE(ClockIn, ClockOut)
+```
+
+## Use Cases
+
+- **SLA monitoring**: Hours since ticket opened
+- **Time tracking**: Work hours calculation
+- **Scheduling**: Hours until deadline
+- **Billing**: Hourly billing calculations
+
+## Related Functions
+
+- [dateminutedifference](./dateminutedifference.md) - Difference in minutes
+- [datedaydifference](./datedaydifference.md) - Difference in days
+- [dateaddhours](./dateaddhours.md) - Add hours to a date
+
+## Notes
+
+- Uses ISO 8601 date format
+- Result can be negative
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datemathadd.md

@@ -0,0 +1,72 @@
+# datemathadd
+
+Generic date math function for adding time units to a date.
+
+## Syntax
+
+```
+datemathadd(date, amount, unit)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `date` | String | Starting date (ISO 8601 format) |
+| `amount` | Number | Amount to add (can be negative) |
+| `unit` | String | Time unit ('days', 'months', 'years', etc.) |
+
+## Returns
+
+String - The resulting date in ISO 8601 format.
+
+## Description
+
+The `datemathadd` function provides a generic way to add various time units to a date. This is an alternative to the specific functions like `dateadddays`, `dateaddmonths`, etc.
+
+## Examples
+
+### Add Days
+
+```expression
+Result = DATEMATHADD("2025-04-01T00:00:00.000Z", 10, "days")
+// Result: "2025-04-11T00:00:00.000Z"
+```
+
+### Add Months
+
+```expression
+Result = DATEMATHADD("2025-04-01T00:00:00.000Z", 3, "months")
+// Result: "2025-07-01T00:00:00.000Z"
+```
+
+### Subtract Years
+
+```expression
+Result = DATEMATHADD("2025-04-01T00:00:00.000Z", -5, "years")
+// Result: "2020-04-01T00:00:00.000Z"
+```
+
+### With Variable Unit
+
+```expression
+NewDate = DATEMATHADD(StartDate, Amount, TimeUnit)
+```
+
+## Use Cases
+
+- **Dynamic date math**: Unit specified at runtime
+- **Generic calculations**: Flexible time operations
+- **Configuration-based**: Configurable time adjustments
+
+## Related Functions
+
+- [dateadddays](./dateadddays.md) - Specific day addition
+- [dateaddmonths](./dateaddmonths.md) - Specific month addition
+- [dateaddyears](./dateaddyears.md) - Specific year addition
+
+## Notes
+
+- Supports various time units
+- Negative values subtract
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datemilliseconddifference.md

@@ -0,0 +1,64 @@
+# datemilliseconddifference
+
+Calculates the difference between two dates in milliseconds.
+
+## Syntax
+
+```
+datemilliseconddifference(startDate, endDate)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | String | Start date (ISO 8601 format) |
+| `endDate` | String | End date (ISO 8601 format) |
+
+## Returns
+
+String - The number of milliseconds between the two dates.
+
+## Description
+
+The `datemilliseconddifference` function calculates how many milliseconds have elapsed between two dates. The result is positive when endDate is after startDate, and negative otherwise.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEMILLISECONDDIFFERENCE("2025-04-01T10:00:00.000Z", "2025-04-01T10:00:00.500Z")
+// Result: "500"
+```
+
+### Performance Measurement
+
+```expression
+ExecutionTime = DATEMILLISECONDDIFFERENCE(StartTime, EndTime)
+```
+
+### Precise Timing
+
+```expression
+LatencyMs = DATEMILLISECONDDIFFERENCE(RequestTime, ResponseTime)
+```
+
+## Use Cases
+
+- **Performance profiling**: Precise execution times
+- **Latency measurement**: Network latency
+- **Animation timing**: Frame durations
+- **Benchmarking**: Comparing execution speeds
+
+## Related Functions
+
+- [dateseconddifference](./dateseconddifference.md) - Difference in seconds
+- [dateaddmilliseconds](./dateaddmilliseconds.md) - Add milliseconds to a date
+
+## Notes
+
+- Uses ISO 8601 date format
+- Result can be negative
+- Highest precision time difference
+- Uses the Dates service internally

package/user-documentation/solverfunctions/dateminutedifference.md

@@ -0,0 +1,64 @@
+# dateminutedifference
+
+Calculates the difference between two dates in minutes.
+
+## Syntax
+
+```
+dateminutedifference(startDate, endDate)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | String | Start date (ISO 8601 format) |
+| `endDate` | String | End date (ISO 8601 format) |
+
+## Returns
+
+String - The number of minutes between the two dates.
+
+## Description
+
+The `dateminutedifference` function calculates how many minutes have elapsed between two dates. The result is positive when endDate is after startDate, and negative otherwise.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEMINUTEDIFFERENCE("2025-04-01T10:00:00.000Z", "2025-04-01T10:45:00.000Z")
+// Result: "45"
+```
+
+### Meeting Duration
+
+```expression
+MeetingLength = DATEMINUTEDIFFERENCE(MeetingStart, MeetingEnd)
+```
+
+### Time Until Event
+
+```expression
+MinutesUntilStart = DATEMINUTEDIFFERENCE(Now, EventStart)
+```
+
+## Use Cases
+
+- **Meeting tracking**: Duration calculations
+- **Response time**: Minutes to respond
+- **Scheduling**: Time intervals
+- **Performance**: Duration metrics
+
+## Related Functions
+
+- [dateseconddifference](./dateseconddifference.md) - Difference in seconds
+- [datehourdifference](./datehourdifference.md) - Difference in hours
+- [dateaddminutes](./dateaddminutes.md) - Add minutes to a date
+
+## Notes
+
+- Uses ISO 8601 date format
+- Result can be negative
+- Uses the Dates service internally

package/user-documentation/solverfunctions/datemonthdifference.md

@@ -0,0 +1,66 @@
+# datemonthdifference
+
+Calculates the difference between two dates in months.
+
+## Syntax
+
+```
+datemonthdifference(startDate, endDate)
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | String | Start date (ISO 8601 format) |
+| `endDate` | String | End date (ISO 8601 format) |
+
+## Returns
+
+String - The number of months between the two dates.
+
+## Description
+
+The `datemonthdifference` function calculates how many months have elapsed between two dates. The result is positive when endDate is after startDate, and negative otherwise.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = DATEMONTHDIFFERENCE("2025-01-15T00:00:00.000Z", "2025-04-15T00:00:00.000Z")
+// Result: "3"
+```
+
+### Negative Result
+
+```expression
+Result = DATEMONTHDIFFERENCE("2025-06-01T00:00:00.000Z", "2025-01-01T00:00:00.000Z")
+// Result: "-5"
+```
+
+### Subscription Length
+
+```expression
+MonthsSubscribed = DATEMONTHDIFFERENCE(SubscriptionStart, Today)
+```
+
+## Use Cases
+
+- **Subscriptions**: Calculate subscription duration
+- **Billing**: Monthly billing periods
+- **Age**: Age in months
+- **Project tracking**: Project duration
+
+## Related Functions
+
+- [datedaydifference](./datedaydifference.md) - Difference in days
+- [dateweekdifference](./dateweekdifference.md) - Difference in weeks
+- [dateyeardifference](./dateyeardifference.md) - Difference in years
+- [dateaddmonths](./dateaddmonths.md) - Add months to a date
+
+## Notes
+
+- Uses ISO 8601 date format
+- Result can be negative
+- Uses the Dates service internally