Add System.Datetime.addMonths()

diff --git a/src/System/Datetime/addMonths/System_Datetime_addMonths.cls b/src/System/Datetime/addMonths/System_Datetime_addMonths.cls
new file mode 100644 (file)
index 0000000..6fd1356
--- /dev/null
+++ b/src/System/Datetime/addMonths/System_Datetime_addMonths.cls
@@ -0,0 +1,42 @@
+/*\r
+ * SPDX-FileCopyrightText: 2024 Chris Duncan <chris@flowpex.dev>\r
+ * SPDX-License-Identifier: GPL-3.0-or-later\r
+ */\r
+\r
+global class System_Datetime_addMonths {\r
+\r
+    @InvocableMethod(label='System.Datetime.addMonths()' category='Flowpex' iconName='slds:standard:event' description='Adds the specified number of months to a Datetime.')\r
+\r
+    global static List<Response> System_Datetime_addMonths (List<Request> requests) {\r
+        List<Response> responses = new List<Response>();\r
+        for (Request req : requests) {\r
+            Response res = new Response();\r
+            try {\r
+                res.newDatetime = req.oldDatetime.addMonths(req.additionalMonths);\r
+            } catch (Exception e) {\r
+                System.debug(e);\r
+            }\r
+            responses.add(res);\r
+        }\r
+        return responses;\r
+    }\r
+\r
+    global class Request {\r
+        @InvocableVariable(required='true' label='Old Datetime' description='Datetime to be incremented.')\r
+        global Datetime oldDatetime;\r
+\r
+        @InvocableVariable(required='true' label='Additional Months' description='Number of months to be added to the Datetime.')\r
+        global Integer additionalMonths;\r
+\r
+        global Request () {}\r
+        global Request (Datetime d, Integer a) {\r
+            this.oldDatetime = d;\r
+            this.additionalMonths = a;\r
+        }\r
+    }\r
+\r
+    global class Response {\r
+        @InvocableVariable(label='New Datetime' description='Datetime incremented by a number of months.')\r
+        global Datetime newDatetime;\r
+    }\r
+}
\ No newline at end of file

diff --git a/src/System/Datetime/addMonths/System_Datetime_addMonths.cls-meta.xml b/src/System/Datetime/addMonths/System_Datetime_addMonths.cls-meta.xml
new file mode 100644 (file)
index 0000000..7d03d55
--- /dev/null
+++ b/src/System/Datetime/addMonths/System_Datetime_addMonths.cls-meta.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+SPDX-FileCopyrightText: 2024 Chris Duncan <chris@flowpex.dev>\r
+SPDX-License-Identifier: GPL-3.0-or-later\r
+-->\r
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">\r
+    <apiVersion>61.0</apiVersion>\r
+    <status>Active</status>\r
+</ApexClass>
\ No newline at end of file

diff --git a/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls b/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls
new file mode 100644 (file)
index 0000000..a0f3aa8
--- /dev/null
+++ b/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls
@@ -0,0 +1,70 @@
+/*\r
+ * SPDX-FileCopyrightText: 2024 Chris Duncan <chris@flowpex.dev>\r
+ * SPDX-License-Identifier: GPL-3.0-or-later\r
+ */\r
+\r
+@isTest\r
+private class System_Datetime_addMonths_TEST {\r
+\r
+    @isTest\r
+    static void testNoArgs () {\r
+        List<System_Datetime_addMonths.Request> requests = new List<System_Datetime_addMonths.Request>();\r
+\r
+        Test.startTest();\r
+        List<System_Datetime_addMonths.Response> responses = System_Datetime_addMonths.System_Datetime_addMonths(requests);\r
+        Test.stopTest();\r
+\r
+        Assert.areEqual(0, responses.size());\r
+    }\r
+\r
+    @isTest\r
+    static void testEmptyRequest () {\r
+        List<System_Datetime_addMonths.Request> requests = new List<System_Datetime_addMonths.Request>();\r
+        System_Datetime_addMonths.Request req = new System_Datetime_addMonths.Request();\r
+        requests.add(req);\r
+\r
+        Test.startTest();\r
+        List<System_Datetime_addMonths.Response> responses = System_Datetime_addMonths.System_Datetime_addMonths(requests);\r
+        Test.stopTest();\r
+\r
+        Assert.areEqual(1, responses.size());\r
+        Assert.isNull(responses[0].newDatetime);\r
+    }\r
+\r
+    @isTest\r
+    static void testBlankArgs () {\r
+        System_Datetime_addMonths.Request req0 = new System_Datetime_addMonths.Request(null, null);\r
+        System_Datetime_addMonths.Request req1 = new System_Datetime_addMonths.Request(Datetime.now(), null);\r
+        System_Datetime_addMonths.Request req2 = new System_Datetime_addMonths.Request(null, 1);\r
+        List<System_Datetime_addMonths.Request> requests = new List<System_Datetime_addMonths.Request>{req0, req1, req2};\r
+\r
+        Test.startTest();\r
+        List<System_Datetime_addMonths.Response> responses = System_Datetime_addMonths.System_Datetime_addMonths(requests);\r
+        Test.stopTest();\r
+\r
+        Assert.areEqual(3, responses.size());\r
+        Assert.isNull(responses[0].newDatetime);\r
+        Assert.isNull(responses[1].newDatetime);\r
+        Assert.isNull(responses[2].newDatetime);\r
+    }\r
+\r
+    @isTest\r
+    static void testManyArgs () {\r
+        Datetime now = Datetime.now();\r
+\r
+        Test.startTest();\r
+        List<System_Datetime_addMonths.Request> requests = new List<System_Datetime_addMonths.Request>();\r
+        for (Integer i = 0; i < 3; i++) {\r
+            System_Datetime_addMonths.Request req = new System_Datetime_addMonths.Request(now, i);\r
+            requests.add(req);\r
+        }\r
+        List<System_Datetime_addMonths.Response> responses = System_Datetime_addMonths.System_Datetime_addMonths(requests);\r
+        Test.stopTest();\r
+\r
+        Assert.areEqual(3, responses.size());\r
+        for (Integer i = 0; i < 3; i++) {\r
+            Datetime d = now.addMonths(i);\r
+            Assert.areEqual(d, responses[i].newDatetime);\r
+        }\r
+    }\r
+}
\ No newline at end of file

diff --git a/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls-meta.xml b/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls-meta.xml
new file mode 100644 (file)
index 0000000..7d03d55
--- /dev/null
+++ b/src/System/Datetime/addMonths/System_Datetime_addMonths_TEST.cls-meta.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+SPDX-FileCopyrightText: 2024 Chris Duncan <chris@flowpex.dev>\r
+SPDX-License-Identifier: GPL-3.0-or-later\r
+-->\r
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">\r
+    <apiVersion>61.0</apiVersion>\r
+    <status>Active</status>\r
+</ApexClass>
\ No newline at end of file