Small adjustments

Author: lauraneto

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

@@ -50,7 +50,7 @@ Without Models Builder:
 
 ## Add values programmatically
 
-When working with this property editor programmatically, understand that it stores values as a JSON object. The object contains the date (as an ISO 8601 string) with time set to midnight and UTC offset.
+This property editor stores values as a JSON object. The object contains the date as an ISO 8601 string with midnight time and UTC offset.
 
 ### Storage format
 
@@ -61,7 +61,7 @@ The property editor stores values in this JSON format:
 }
 ```
 
-The property editor handles date-only values. The time is automatically set to 00:00:00 and offset to +00:00 for storage consistency. These time components are not used in the Date Only context.
+The property editor handles date-only values. Time is set to 00:00:00 and offset to +00:00 for storage consistency. These time components are ignored in Date Only context.
 
 1. Create a C# model that matches the JSON schema.
 
@@ -80,19 +80,19 @@ The property editor handles date-only values. The time is automatically set to 0
     }
     ```
 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);
-    ```
+   ```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);
-    ```
+   ```csharp
+   DateTime dateTime = DateTime.Today; // Your existing DateTime value
+   DateOnly dateOnly = DateOnly.FromDateTime(dateTime);
+   DateTimeOffset dateTimeOffset = dateOnly.ToDateTime(TimeOnly.MinValue);
+   ```
 
 3. Create an instance of the class with the `DateTimeOffset` value.
     ```csharp
@@ -103,17 +103,17 @@ The property editor handles date-only values. The time is automatically set to 0
     ```
 
 4. Inject the `IJsonSerializer` and use it to serialize the object.
-    ```csharp
-    string jsonValue = _jsonSerializer.Serialize(value);
-    ```
-    
+   ```csharp
+   string jsonValue = _jsonSerializer.Serialize(value);
+   ```
+
 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");
+   ```csharp
+   IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 
-    // Set the value of the property with alias 'eventDate'. 
-    content.SetValue("eventDate", jsonValue);
+   // Set the value of the property with alias 'eventDate'. 
+   content.SetValue("eventDate", jsonValue);
 
-    // Save the change
-    _contentService.Save(content);
-    ```
+   // Save the change
+   _contentService.Save(content);
+   ```

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

@@ -6,7 +6,7 @@
 
 `Returns: DateTime?`
 
-The Date Time (Unspecified) property editor provides a comprehensive interface for selecting dates and times without time zone information.
+The Date Time (Unspecified) property editor provides a comprehensive interface for selecting dates and times. It excludes time zone information.
 
 ## Key Features
 
@@ -40,7 +40,7 @@ Use this when you need more precise timing.
 
 ### Adding or editing a value
 
-You will be presented with a date and time input. Unlike the time zone version, this editor focuses only on the date and time components.
+You will be presented with a date and time input. This editor focuses only on the date and time components, unlike the time zone version.
 
 ![Date Time Unspecified property editor interface](../built-in-umbraco-property-editors/images/date-time-unspecified-editor.png)
 
@@ -62,7 +62,7 @@ Without Models Builder:
 
 ## Add values programmatically
 
-When working with this property editor programmatically, understand that it stores values as a JSON object. The object contains the date (as an ISO 8601 string).
+This property editor stores values as a JSON object. The object contains the date as an ISO 8601 string.
 
 ### Storage format
 
@@ -73,7 +73,7 @@ The property editor stores values in this JSON format:
 }
 ```
 
-The property editor handles unspecified date times with no time zone information. The value is stored with offset +00:00 for consistency. The offset is not used unless you replace the property editor with the Date Time (with time zone) version.
+The property editor handles unspecified date times with no time zone information. The value is stored with offset +00:00 for consistency. The offset is ignored unless you replace this editor with the Date Time (with time zone) version.
 
 1. Create a C# model that matches the JSON schema.
 
@@ -93,31 +93,31 @@ The property editor handles unspecified date times with no time zone information
     ```
 
 2. Convert your existing DateTime value to `DateTimeOffset` for storage.
-    ```csharp
-    DateTime dateTime = DateTime.Now; // Your existing DateTime value
-    DateTimeOffset dateTimeOffset = dateTime; // Explicit conversion
-    ```
+   ```csharp
+   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
-    };
-    ```
-
- 4. Inject the `IJsonSerializer` and use it to serialize the object.
-    ```csharp
-    string jsonValue = _jsonSerializer.Serialize(value);
-    ```
+   ```csharp
+   var value = new DateTimeUnspecified
+   {
+       Date = dateTimeOffset
+   };
+   ```
+
+4. Inject the `IJsonSerializer` and use it to serialize the object.
+   ```csharp
+   string jsonValue = _jsonSerializer.Serialize(value);
+   ```
 
 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");
+   ```csharp
+   IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 
-    // Set the value of the property with alias 'eventDateTime'. 
-    content.SetValue("eventDateTime", jsonValue);
+   // Set the value of the property with alias 'eventDateTime'. 
+   content.SetValue("eventDateTime", jsonValue);
 
-    // Save the change
-    _contentService.Save(content);
-    ```
+   // Save the change
+   _contentService.Save(content);
+   ```

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

@@ -6,7 +6,7 @@
 
 `Returns: DateTimeOffset?`
 
-The Date Time with Time Zone property editor provides a comprehensive interface for selecting dates, times, and time zones. It stores values as ISO 8601 date/time strings with time zone information. This makes it ideal for applications that need to handle dates across different time zones accurately.
+The Date Time with Time Zone property editor provides a comprehensive interface for selecting dates, times, and time zones. It stores values as ISO 8601 date/time strings with time zone information. This makes it ideal for applications that need accurate date handling across different time zones.
 
 ## Key Features
 
@@ -44,7 +44,7 @@ Use this when you need more precise timing.
 - **Local** - Displays only the local time zone of the user's browser/computer.
 Useful for simplifying the UI when time entries should always be based on the user’s local context.
 - **Custom** - Allows you to define a list of time zones.
-When you select this option, a dropdown appears. You can search and select from the full IANA time zone list. Add multiple zones to restrict user selection to only those you specify.
+When you select this option, a dropdown appears. You can search and select from the full IANA time zone list. Add multiple zones to restrict user selection to only the zones you specify.
     - Example:  
         Selecting the following time zones:
         - `Coordinated Universal Time (UTC)`
@@ -60,11 +60,11 @@ Daylight saving time (DST) is also taken into account.
 
 ### Adding or editing a value
 
-You will be presented with a date, time and time zone input. The time zone input allows for typing, which filters the list of presented time zones.
+You will be presented with date, time and time zone inputs. The time zone input allows typing, which filters the list of presented time zones.
 
 ![Date Time with Time Zone property editor showing time zone dropdown with filtering functionality as user types](../built-in-umbraco-property-editors/images/date-time-with-time-zone-filtering.png)
 
-If your browser time zone is in the list, and no date has been stored yet, the browser time zone will be pre-selected by default.
+If your browser time zone is in the list and no date has been stored yet, the browser time zone will be pre-selected by default.
 
 If only one time zone is available, you will see a simple label with the time zone name instead.
 
@@ -106,7 +106,7 @@ DateTime? utcDateTime = Model.EventDateTime?.UtcDateTime;
 
 ## Add values programmatically
 
-When working with this property editor programmatically, it's important to understand that it stores values as a JSON object containing both the date (as an ISO 8601 string) and the selected time zone (as an IANA identifier).
+This property editor stores values as a JSON object. The object contains both the date (as an ISO 8601 string) and the selected time zone (as an IANA identifier).
 
 ### Storage format
 
@@ -142,26 +142,26 @@ The property editor stores values in this JSON format:
     ```
 
 2. Create an instance of the created class with the desired values.
-    ```csharp
-    var value = new DateTimeWithTimeZone
-    {
-        Date = DateTimeOffset.Now, // The date and time value to store.
-        TimeZone = "Europe/Copenhagen" // The time zone to pre-select in the editor.
-    };
-    ```
+   ```csharp
+   var value = new DateTimeWithTimeZone
+   {
+       Date = DateTimeOffset.Now, // The date and time value to store.
+       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);
-    ```
+   ```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");
+   ```csharp
+   IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 
-    // Set the value of the property with alias 'eventDateTime'. 
-    content.SetValue("eventDateTime", jsonValue);
+   // Set the value of the property with alias 'eventDateTime'. 
+   content.SetValue("eventDateTime", jsonValue);
 
-    // Save the change
-    _contentService.Save(content);
-    ```
+   // Save the change
+   _contentService.Save(content);
+   ```

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

@@ -6,7 +6,7 @@
 
 `Returns: TimeOnly?`
 
-The Time Only property editor provides a simple interface for selecting times without date or time zone information. It focuses purely on time selection and returns strongly-typed `TimeOnly` values.
+The Time Only property editor provides a simple interface for selecting times. It excludes date or time zone information and returns strongly-typed `TimeOnly` values.
 
 ## Key Features
 
@@ -64,7 +64,7 @@ Without Models Builder:
 
 ## Add values programmatically
 
-When working with this property editor programmatically, understand that it stores values as a JSON object. The object contains the time (as an ISO 8601 string) with a default date and UTC offset.
+This property editor stores values as a JSON object. The object contains the time as an ISO 8601 string with a default date and UTC offset.
 
 ### Storage format
 
@@ -75,7 +75,7 @@ The property editor stores values in this JSON format:
 }
 ```
 
-The property editor handles time-only values. The date is automatically set to a default value (0001-01-01) and offset to +00:00 for storage consistency. The date component is not used in the Time Only context.
+The property editor handles time-only values. Date is set to a default value (0001-01-01) and offset to +00:00 for storage consistency. The date component is ignored in Time Only context.
 
 1. Create a C# model that matches the JSON schema.
 
@@ -95,19 +95,19 @@ The property editor handles time-only values. The date is automatically set to a
     ```
 
 2. Convert your existing time value to `DateTimeOffset` for storage.
-   
+
    If you have a `TimeOnly`:
-    ```csharp
-    TimeOnly timeOnly = TimeOnly.FromDateTime(DateTime.Now); // Your existing TimeOnly value
-    DateTimeOffset dateTimeOffset = new DateTimeOffset(DateOnly.MinValue, timeOnly, TimeSpan.Zero);
-    ```
+   ```csharp
+   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);
-    ```
+   ```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
@@ -118,17 +118,17 @@ The property editor handles time-only values. The date is automatically set to a
     ```
 
 4. Inject the `IJsonSerializer` and use it to serialize the object.
-    ```csharp
-    string jsonValue = _jsonSerializer.Serialize(value);
-    ```
+   ```csharp
+   string jsonValue = _jsonSerializer.Serialize(value);
+   ```
 
 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");
+   ```csharp
+   IContent content = _contentService.GetById(contentKey) ?? throw new Exception("Content not found");
 
-    // Set the value of the property with alias 'startHours'. 
-    content.SetValue("startHours", jsonValue);
+   // Set the value of the property with alias 'startHours'. 
+   content.SetValue("startHours", jsonValue);
 
-    // Save the change
-    _contentService.Save(content);
-    ```
+   // Save the change
+   _contentService.Save(content);
+   ```