You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The Date Time property editors provide interfaces for selecting dates, times, and time zones. Each editor is designed for specific use cases, from basic date selection to comprehensive date/time handling with time zone support.
4
+
5
+
{% hint style="info" %}
6
+
These property editors supersede the [Date Time](../date-time.md) property editor, offering more focused functionality and specific return types (like `DateOnly`, `TimeOnly`, `DateTime`, or `DateTimeOffset`). You can switch from the legacy Date Time editor by changing your properties to use data types with these new editors.
7
+
{% endhint %}
8
+
9
+
Umbraco CMS currently ships with four Date Time editors:
10
+
11
+
## [Date Only](date-only.md)
12
+
13
+
For selecting dates without time or time zone information. Returns `DateOnly?` values and is ideal for birthdays, deadlines, and event dates.
14
+
15
+
16
+
17
+
## [Time Only](time-only.md)
18
+
19
+
For selecting times without date or time zone information. Returns `TimeOnly?` values and is ideal for business hours, schedules, and time-based events.
20
+
21
+
22
+
23
+
## [Date Time (Unspecified)](date-time-unspecified.md)
24
+
25
+
For selecting dates and times without time zone information. Returns `DateTime?` values and is compatible with existing [DateTime](../date-time.md) editor.
26
+
27
+
28
+
29
+
## [Date Time (with Time Zone)](date-time-with-time-zone.md)
30
+
31
+
For comprehensive date, time, and time zone selection. Returns `DateTimeOffset?` values and handles time zones, daylight saving time, and international date/time scenarios.
32
+
33
+
Copy file name to clipboardExpand all lines: 16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-editor/date-only.md
+1-10Lines changed: 1 addition & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,15 +8,6 @@
8
8
9
9
The Date Only property editor provides an interface for selecting dates without time or time zone information. It focuses purely on date selection and returns `DateOnly` values.
10
10
11
-
## Key Features
12
-
13
-
- Calendar-based date selection
14
-
- No time or time zone components
15
-
- Focused interface
16
-
- Returns strongly-typed `DateOnly?` values
17
-
- Ideal for birthdays, deadlines, and event dates
18
-
- No configuration required
19
-
20
11
## Configuration
21
12
You can configure this property editor in the same way as any standard property editor, using the *Data Types* admin interface.
22
13
@@ -30,7 +21,7 @@ This editor has no configuration options.
30
21
31
22
You will be presented with a date input.
32
23
33
-
24
+
Copy file name to clipboardExpand all lines: 16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-editor/date-time-unspecified.md
+4-12Lines changed: 4 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,41 +8,33 @@
8
8
9
9
The Date Time (Unspecified) property editor provides a comprehensive interface for selecting dates and times. It excludes time zone information.
10
10
11
-
## Key Features
12
-
13
-
- Calendar-based date selection
14
-
- Configurable time precision (hours/minutes or hours/minutes/seconds)
15
-
- No time zone handling - stores pure date/time values
16
-
- Returns strongly-typed `DateTime?` values
17
-
- Compatible with existing DateTime-based editors
18
-
19
11
## Configuration
20
12
You can configure this property editor in the same way as any standard property editor, using the *Data Types* admin interface.
21
13
22
14
To set up a property using this editor, create a new *Data Type* and select **Date Time (unspecified)** from the list of available property editors.
23
15
24
16
You will see the configuration options as shown below.
25
17
26
-
18
+
27
19
28
20
-**Time format** - Specifies the level of precision for time values shown and stored by the editor.
29
21
30
22
### Time format
31
23
32
24
-**HH:mm** - Displays hours and minutes (e.g., `14:30`).
33
25
Suitable for most general use cases.
34
-
26
+
35
27
-**HH:mm:ss** - Displays hours, minutes, and seconds (e.g., `14:30:45`).
36
28
Use this when you need more precise timing.
37
-
29
+
38
30
39
31
## Editing experience
40
32
41
33
### Adding or editing a value
42
34
43
35
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.
44
36
45
-
37
+
Copy file name to clipboardExpand all lines: 16/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-editor/date-time-with-time-zone.md
+8-15Lines changed: 8 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,23 +8,14 @@
8
8
9
9
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.
10
10
11
-
## Key Features
12
-
13
-
- Calendar-based date selection
14
-
- Configurable time precision (hours/minutes or hours/minutes/seconds)
15
-
- Flexible time zone configuration (all zones, local only, or custom selection)
16
-
- Automatic daylight saving time handling
17
-
- Type-ahead filtering for time zone selection
18
-
- Returns strongly-typed `DateTimeOffset?` values
19
-
20
11
## Configuration
21
12
You can configure this property editor in the same way as any standard property editor, using the *Data Types* admin interface.
22
13
23
14
To set up a property using this editor, create a new *Data Type* and select **Date Time (with time zone)** from the list of available property editors.
24
15
25
16
You will see the configuration options as shown below.
26
17
27
-
18
+
28
19
29
20
-**Time format** - Specifies the level of precision for time values shown and stored by the editor.
30
21
-**Time zones** - Controls how time zones are available in the property editor.
@@ -33,10 +24,10 @@ You will see the configuration options as shown below.
33
24
34
25
-**HH:mm** - Displays hours and minutes (e.g., `14:30`).
35
26
Suitable for most general use cases.
36
-
27
+
37
28
-**HH:mm:ss** - Displays hours, minutes, and seconds (e.g., `14:30:45`).
38
29
Use this when you need more precise timing.
39
-
30
+
40
31
41
32
### Time zones
42
33
@@ -50,7 +41,7 @@ When you select this option, a dropdown appears. You can search and select from
50
41
- `Coordinated Universal Time (UTC)`
51
42
- `Europe/Copenhagen`
52
43
Will result in the following editing experience:
53
-
44
+
54
45
55
46
The selected time zone affects how the date/time is displayed and stored.
56
47
When you select a time zone, the value will be saved with the corresponding offset (e.g., `2025-01-01T14:30:00+01:00`).
@@ -62,13 +53,15 @@ Daylight saving time is also taken into account.
62
53
63
54
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.
64
55
65
-
56
+
66
57
67
58
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.
68
59
60
+
When you select a time zone different from your browser's local time zone, the editor displays a helpful conversion message. This shows what the selected date and time would be equivalent to in your local time zone, making it easier to understand the time difference.
61
+
69
62
If only one time zone is available, you will see a label with the time zone name instead.
70
63
71
-
64
+
0 commit comments