diff --git a/docs/fieldtypes/date.md b/docs/fieldtypes/date.md index 8321403ab..75a70497d 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 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 the time into the 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 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. ## Template Tag