Merge pull request #714 from vitspec99/next_minor

Author: jaredhendrickson13

pfSense-pkg-RESTAPI/files/usr/local/pkg/RESTAPI/Endpoints/SystemTimezoneEndpoint.inc

@@ -0,0 +1,25 @@
+<?php
+
+namespace RESTAPI\Endpoints;
+
+require_once 'RESTAPI/autoloader.inc';
+
+use RESTAPI\Core\Endpoint;
+
+/**
+ * Defines an Endpoint for interacting with the SystemTimezone Model object at
+ * /api/v2/system/timezone.
+ */
+class SystemTimezoneEndpoint extends Endpoint {
+    public function __construct() {
+        # Set Endpoint attributes
+        $this->url = '/api/v2/system/timezone';
+        $this->model_name = 'SystemTimezone';
+        $this->request_method_options = ['GET', 'PATCH'];
+        $this->get_help_text = 'Reads the current system timezone.';
+        $this->patch_help_text = 'Updates the system timezone.';
+
+        # Construct the parent Endpoint object
+        parent::__construct();
+    }
+}

pfSense-pkg-RESTAPI/files/usr/local/pkg/RESTAPI/Models/SystemTimezone.inc

@@ -0,0 +1,47 @@
+<?php
+
+namespace RESTAPI\Models;
+
+use RESTAPI\Core\Model;
+use RESTAPI\Fields\StringField;
+use RESTAPI\Responses\ValidationError;
+
+/**
+ * Defines a Model that represents the Timezone configuration on this system.
+ */
+class SystemTimezone extends Model {
+    public StringField $timezone;
+
+    public function __construct(mixed $id = null, mixed $parent_id = null, mixed $data = [], mixed ...$options) {
+        # Set model attributes
+        $this->config_path = 'system';
+        $this->update_strategy = 'merge';
+        $this->always_apply = true;
+
+        # Set model Fields
+        $this->timezone = new StringField(
+            default: 'Etc/GMT',
+            allow_empty: false,
+            allow_null: false,
+            many: false,
+            choices_callable: 'get_timezone_choices',
+            help_text: 'Set geographic region name (Continent/Location) to determine the timezone for the firewall.'
+        );
+
+        parent::__construct($id, $parent_id, $data, ...$options);
+    }
+
+    /**
+     * Apply these Timezone changes to the system.
+     */
+    public function apply() {
+        system_timezone_configure();
+    }
+
+    /*
+     *
+     */
+    public function get_timezone_choices(): array {
+        return system_get_timezone_list();
+    }
+}