Updated code samples

Author: lauraneto

16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-only.md

@@ -79,19 +79,35 @@ The property editor handles date-only values. The time is automatically set to 0
         public DateTimeOffset Date { get; init; }
     }
     ```
+2. Convert your existing date value to `DateTimeOffset` for storage.
+   
+   If you have a `DateOnly`:
+    ```csharp
+    DateOnly dateOnly = DateOnly.FromDateTime(DateTime.Today); // Your existing DateOnly value
+    DateTimeOffset dateTimeOffset = dateOnly.ToDateTime(TimeOnly.MinValue);
+    ```
+
+   If you have a `DateTime`:
+    ```csharp
+    DateTime dateTime = DateTime.Today; // Your existing DateTime value
+    DateOnly dateOnly = DateOnly.FromDateTime(dateTime);
+    DateTimeOffset dateTimeOffset = dateOnly.ToDateTime(TimeOnly.MinValue);
+    ```
 
-2. Create an instance of the class with the desired values.
+3. Create an instance of the class with the `DateTimeOffset` value.
     ```csharp
-    var value = new DateOnlyValue
+    DateOnlyValue value = new DateOnlyValue
     {
-        Date = new DateTimeOffset(DateTime.Today) // The value to store as a `DateTimeOffset`
+        Date = dateTimeOffset
     };
     ```
-3. Inject the `IJsonSerializer` and use it to serialize the object.
+
+4. Inject the `IJsonSerializer` and use it to serialize the object.
     ```csharp
-    var jsonValue = _jsonSerializer.Serialize(value);
+    string jsonValue = _jsonSerializer.Serialize(value);
     ```
-4. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
+    
+5. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
     ```csharp
     IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 

16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-unspecified.md

@@ -82,28 +82,36 @@ The property editor handles unspecified date times with no time zone information
 
     namespace UmbracoProject;
 
-    public class DateTimeWithTimeZone
+    public class DateTimeUnspecified
     {
         /// <summary>
-        /// The date and time value, represented as a <see cref="DateTimeOffset"/>.
+        /// The date and time value, represented as a <see cref="DateTimeOffset"/> for storage compatibility.
         /// </summary>
         [JsonPropertyName("date")]
         public DateTimeOffset Date { get; init; }
     }
     ```
 
-2. Create an instance of the class with the desired values.
+2. Convert your existing DateTime value to `DateTimeOffset` for storage.
     ```csharp
-    var value = new DateTimeWithTimeZone
+    DateTime dateTime = DateTime.Now; // Your existing DateTime value
+    DateTimeOffset dateTimeOffset = dateTime; // Explicit conversion
+    ```
+
+3. Create an instance of the class with the `DateTimeOffset` value.
+    ```csharp
+    var value = new DateTimeUnspecified
     {
-        Date = DateTimeOffset.Parse("2025-01-01T14:30") // The date and time value to store.
+        Date = dateTimeOffset
     };
     ```
-3. Inject the `IJsonSerializer` and use it to serialize the object.
+
+ 4. Inject the `IJsonSerializer` and use it to serialize the object.
     ```csharp
-    var jsonValue = _jsonSerializer.Serialize(value);
+    string jsonValue = _jsonSerializer.Serialize(value);
     ```
-4. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
+
+5. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
     ```csharp
     IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 

16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-with-time-zone.md

@@ -137,7 +137,7 @@ The property editor stores values in this JSON format:
         /// The IANA identifier of the time zone to pre-select in the editor. E.g., "Europe/Copenhagen".
         /// </summary>
         [JsonPropertyName("timeZone")]
-        public string? TimeZone { get; init; }
+        public string TimeZone { get; init; }
     }
     ```
 
@@ -146,13 +146,15 @@ The property editor stores values in this JSON format:
     var value = new DateTimeWithTimeZone
     {
         Date = DateTimeOffset.Now, // The date and time value to store.
-        TimeZone = "Europe/Copenhagen" // Optional. The time zone to pre-select in the editor.
+        TimeZone = "Europe/Copenhagen" // The time zone to pre-select in the editor.
     };
     ```
+
 3. Inject the `IJsonSerializer` and use it to serialize the object.
     ```csharp
     var jsonValue = _jsonSerializer.Serialize(value);
     ```
+
 4. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
     ```csharp
     IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");

16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/time-only.md

@@ -94,19 +94,35 @@ The property editor handles time-only values. The date is automatically set to a
     }
     ```
 
-2. Create an instance of the class with the desired values.
+2. Convert your existing time value to `DateTimeOffset` for storage.
+   
+   If you have a `TimeOnly`:
     ```csharp
-    var timeOnly = new TimeOnly(14, 30, 0);
-    var value = new TimeOnlyValue
+    TimeOnly timeOnly = TimeOnly.FromDateTime(DateTime.Now); // Your existing TimeOnly value
+    DateTimeOffset dateTimeOffset = new DateTimeOffset(DateOnly.MinValue, timeOnly, TimeSpan.Zero);
+    ```
+
+   If you have a `DateTime`:
+    ```csharp
+    DateTime dateTime = DateTime.Now; // Your existing DateTime value
+    TimeOnly timeOnly = TimeOnly.FromDateTime(dateTime);
+    DateTimeOffset dateTimeOffset = new DateTimeOffset(DateOnly.MinValue, timeOnly, TimeSpan.Zero);
+    ```
+
+3. Create an instance of the class with the `DateTimeOffset` value.
+    ```csharp
+    TimeOnlyValue value = new TimeOnlyValue
     {
-        Date = timeOnly.ToDateTime(DateOnly.MinValue) // Convert TimeOnly to DateTimeOffset for storage
+        Date = dateTimeOffset
     };
     ```
-3. Inject the `IJsonSerializer` and use it to serialize the object.
+
+4. Inject the `IJsonSerializer` and use it to serialize the object.
     ```csharp
-    var jsonValue = _jsonSerializer.Serialize(value);
+    string jsonValue = _jsonSerializer.Serialize(value);
     ```
-4. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
+
+5. Inject the `IContentService` to retrieve and update the value of a property of the desired content item.
     ```csharp
     IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");