From 71a301c17816cbbe4462ac0f8804366581ec8e3d Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 10 May 2023 14:19:42 +0300 Subject: [PATCH 1/3] "show time" setting for date field also added examples of localized vs fixed time --- docs/fieldtypes/date.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/fieldtypes/date.md b/docs/fieldtypes/date.md index 8321403ab..bb0582abb 100755 --- a/docs/fieldtypes/date.md +++ b/docs/fieldtypes/date.md @@ -15,13 +15,25 @@ The Date field allows for quick entry of dates via the publish form. When the fi ## Field Settings -### Localized or Fixed? +### Date Localization -On the publish form, along with a field to enter a date, you will also see an option to select whether you want the date localized or fixed: +Choose how the field data should be localized. The options are +- _Always localized_ (the date displayed on front-end will be converted into logged-in member's timezone. Example use case is start of online event, when attenders need to know their local time) +- _Alway fixed_ (the date on front-end will be displayed in the site's configured timezone. Example use case is start of in-person event, when attenders need to know the time as it is in the event's timezone) +- _Ask each time_ + +### Include time? +When turned off, only date will be displayed, otherwise the editor can also enter time into same field. + +## Publish form + +On the publish form (when `Date Localization` setting is set to `Ask each time`), along with a field to enter a date, you will also see an option to select whether you want the date localized or fixed: - **Localized:** A date that is localized will be translated into the logged-in member's current timezone. For instance, if you enter a date of _10/21/2015 4:29 PM_ and you're in Pacific Daylight Time, a member in Eastern Daylight Time will see the date as _10/21/2015 7:29 PM_. Or, for logged out members, the date will be localized on the front-end according to the site's configured timezone. - **Fixed:** A fixed date will NOT be localized to a member's timezone, or the site's configured timezone. The date will appear as it does in the control panel everywhere by all members. +NOTE: **Note:** These options are only available when using Date as field and not as Grid column. + At the bottom of the calendar popup you will also see a "Today" button that can be used to automatically set the date to the current date. ## Template Tag From b431006833cb575b12de88e3bfb18c4955c3ebc1 Mon Sep 17 00:00:00 2001 From: Matt Johnson Date: Fri, 2 Jun 2023 17:10:56 -0500 Subject: [PATCH 2/3] Update date.md --- docs/fieldtypes/date.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fieldtypes/date.md b/docs/fieldtypes/date.md index bb0582abb..5aebd08f0 100755 --- a/docs/fieldtypes/date.md +++ b/docs/fieldtypes/date.md @@ -18,12 +18,12 @@ The Date field allows for quick entry of dates via the publish form. When the fi ### Date Localization Choose how the field data should be localized. The options are -- _Always localized_ (the date displayed on front-end will be converted into logged-in member's timezone. Example use case is start of online event, when attenders need to know their local time) -- _Alway fixed_ (the date on front-end will be displayed in the site's configured timezone. Example use case is start of in-person event, when attenders need to know the time as it is in the event's timezone) +- _Always localized_ (the date displayed on the front-end will be converted into the logged-in member's timezone. An example use case is the start of an online event, when attenders need to know their local time) +- _Alway fixed_ (the date on the front-end will be displayed in the site's configured timezone. An example use case is the start of an in-person event, when attenders need to know the time as it is in the event's timezone) - _Ask each time_ ### Include time? -When turned off, only date will be displayed, otherwise the editor can also enter time into same field. +When turned off, only date will be displayed, otherwise the editor can also enter the time into the same field. ## Publish form From 883beade0363d5db806d9f85a85b6fd7d272c817 Mon Sep 17 00:00:00 2001 From: Matt Johnson Date: Fri, 2 Jun 2023 17:11:26 -0500 Subject: [PATCH 3/3] Update date.md --- docs/fieldtypes/date.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fieldtypes/date.md b/docs/fieldtypes/date.md index 5aebd08f0..75a70497d 100755 --- a/docs/fieldtypes/date.md +++ b/docs/fieldtypes/date.md @@ -32,7 +32,7 @@ On the publish form (when `Date Localization` setting is set to `Ask each time`) - **Localized:** A date that is localized will be translated into the logged-in member's current timezone. For instance, if you enter a date of _10/21/2015 4:29 PM_ and you're in Pacific Daylight Time, a member in Eastern Daylight Time will see the date as _10/21/2015 7:29 PM_. Or, for logged out members, the date will be localized on the front-end according to the site's configured timezone. - **Fixed:** A fixed date will NOT be localized to a member's timezone, or the site's configured timezone. The date will appear as it does in the control panel everywhere by all members. -NOTE: **Note:** These options are only available when using Date as field and not as Grid column. +NOTE: **Note:** These options are only available when using Date as a field and not as a Grid column. At the bottom of the calendar popup you will also see a "Today" button that can be used to automatically set the date to the current date.