Allow to set Timezone name

Author: vitspec99

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,55 @@
+<?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,
+            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 validate_extra(): void {
+        $tzlist = system_get_timezone_list();
+
+        $tz = $this->timezone->value;
+
+        if ( ! in_array($tz, $tzlist) ) {
+            throw new ValidationError(
+                message: "Unknown timezone={$tz}",
+                response_id: 'TIMEZONE_UNKNOWN_TIMEZONE',
+            );
+        }
+    }
+}